NASA Technical Memorandum 101500 


Integrated Multidisciplinary Analysis Tool 


IMAT 

USER’S GUIDE 

FOR THE VAX/ VMS COMPUTER 


Edited by Frances T. Meissner 


December 1988 


(KASA-TH-1015C0) IMA1 (INIECEA1ED Nay-144 

ft LLT I DISC IE LI NA f Y ANALYSIS ICC!) USEB'S 
GUIDE FOE THE VII/VWS CCHPUIIf (NASA) 

2-1 p CSCL 20K Unclas 

G3/39 0187242 


NASA 

National Aeronautics and 
Space Administration 

Langley Research Center 

Hampton, Virginia 23665-5225 




PREFACE 


The Integrated Multidisciplinary Analysis Tool (IMAT) is a computer 
software system for the VAX/VMS computer that has been 
developed at the Langley Research Center. IMAT provides 
researchers and analysts with an efficient capability to analyze 
satellite control systems influenced by structural dynamics. Using a 
menu-driven executive system, IMAT leads the user through the 
program options. IMAT links a relational database manager to 
commercial and in-house structural and controls analysis codes. This 
paper describes the IMAT software system and how to use it. 
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Software Overview 1 


The Integrated Multidisciplinary Analysis Tool (IMAT) is a computer 
software system consisting of modular processors designed to transfer 
information to and from various structures and controls software 
packages via a central database management system. In general, each 
processor either takes information from the database and formats it 
for use in the user software package or converts the data obtained 
from the software package into a form to be accepted by the database. 
In this manner, information may be shared by researchers using 
different software packages. New application software can be attached 
to IMAT by writing a processor to format information from the 
database into the new application and by writing another processor to 
put the results into the database. Figure 1 is a graphic representation 
of the IMAT system of processors. 

The IMAT EXECUTIVE is an interactive menu-driven system which 
leads the user through the program options. The IMAT EXECUTIVE 
resides on a Digital Equipment Corporation VAX with the VMS 
operating system. IMAT features include: 

1 . A database management system. Relational Information 
Management System (RIM) by Boeing Computer Services is the 
database manager. An important feature of RIM databases is 
portability. A RIM database may be transferred from the VAX to a 
variety of computer systems. The researcher need not be familiar 
with the RIM commands to use IMAT. 

2. Maintained IMAT database schema. Each database has a consistent 
schema defined by the database dictionary. This ensures that all 
databases created by the IMAT software may be used by all of the 
IMAT processors and shared by IMAT users. 

3. Utility processors for database creation, query, and unload. The 
user does not need to know any database commands to create or 
interrogate the database. 
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Software Overview 2 


4. Access to software applications packages. Commercial as well as 
in-house code is available through the IMAT EXECUTIVE. IMAT has 
computer-aided design code, finite element generators, structural 
analysis code, controls analysis code, and plotting packages. The 
commercial code includes MSC/NASTRAN, I-DEAS (GEOMOD and 
SUPERTAB), and MATRIXx/SYSTEM_BUILD. The plotting software 
includes DI-3000 and PicSure. Controls software, developed in-house, 
is available which generates linear systems matrices used to model 
rigid body and flexible motion of a structure with feedback control. 

5. Plotting capabilities. DI-3000 metafiles can be generated from 
I-DEAS, MATRIXx or MSC/NASTRAN plot files. PicSure can be 
executed either interactively or from a command file generated to plot 
analysis data from MATRIXx or MSC/NASTRAN. 
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List of Commercial Software Packages 1 


Dl-3000 and PicSure, developed by Precision Visuals, Incorporated, arc 
versatile graphics software tools. DI-3000 provides a library of over 
200 FORTRAN-callable two- and three-dimensional graphics subroutines. 
Dl-3000 is device and machine independent. Tailored interfaces for over 
70 graphics devices allow application programs that are written for a 
"virtual graphics device" to automatically utilize the full features of 
any supported display terminal. DI-3000’s full color features include 
three-dimensional viewing, window clipping and depth clipping, and 
graphics quality text. 

PicSure is a graphics system for producing professional quality charts and 
graphs. PicSure is also machine and device independent. 

REFERENCES: 

DI-3000 USER’S GUIDE, March 1986, Precision Visuals, Inc. 

PicSure USER'S GUIDE, October 1986, Precision Visuals, Inc. 


I-DEAS GEOMOD, Structural Dynamics Research Corporation's interactive 
graphics solid geometry modeling program, can be used to create complex 
solid objects. Two or more objects can be combined using simple Boolean 
operations. Physical properties of completed objects can be easily 
obtained, and finished geometry can be transferred to finite element 
preprocessors for mesh generation. A rigid body mechanism analysis is 
also available. 

REFERENCE: 

I-DEAS GEOMOD SOLID MODELING AND DESIGN REFERENCE 
MANUAL, LEVEL 3, 1986, Structural Dynamics Research 
Corporation 
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List of Commercial Software Packages 2 


MATRIXx, a product of Integrated Systems Incorporated, is a 
programmable set of matrix subroutines that performs design and 
analysis functions for either classical or modern control 
problems. SYSTEM_BUILD, an optional capability of MATRIXx, 
provides an interactive graphics tool for building, modeling and 
editing computer simulation models. Complex linear or non-linear 
systems can be assembled from basic building blocks. Simulation 
can be performed using a variety of integration algorithms and 
results can be displayed graphically. 

REFERENCE: 

MATRIXx USER'S GUIDE, VERSION 6, 1986, Integrated Systems Inc. 


MSC/NASTRAN is a version of the general purpose structural 
analysis program that has been developed and is maintained by the 
MacNeal-Schwendler Corporation. The MSC/NASTRAN code has an 
open architecture that allows researchers to easily modify structured 
solution sequences to solve non-standard static and dynamic structural 
analysis problems using the finite element method. 

REFERENCE: 

MSC/NASTRAN USER'S MANUAL, Version 65, 1985, 

The MacNeal-Schwendler Corporation 


Relational Information Management System (RIM) is a database 
management system developed by Boeing Computer Services. RIM is 
based on the relational algebra model for data management. Data 
grouped in tables called relations can be manipulated using relational 
algebra commands. RIM features a built-in interface to FORTRAN, COBOL, 
or PASCAL application programs, an English-like command language for 
data qualification, and facilities for the transfer of data between different 
machines. 

REFERENCE: 

RIM - RELATIONAL INFORMATION MANAGEMENT SYSTEM USER'S 

MANUAL, 1985, The Boeing Company 
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List of Commercial Software Packages 3 


I DEAS SUPERTAB, a product of Structural Dynamics Research 
Corporation, is an interactive graphics pre and postprocessor that can be 
used on a variety of graphics terminals to create finite element models. 
SUPERTAB contains translators that can create data files for input to 
commercial finite element codes such as MSC/NASTRAN. Analysis results 
can be displayed in various forms, including deformed structure plots, 
color stress contours, and X, Y plots. 

REFERENCE: 

I DEAS SUPERTAB USER’S MANUAL, LEVEL 3, 1986, 

Structural Dynamics Research Corporation 
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Solution Procedure Overview 1 


The approach to the analysis of the dynamic behavior of structures 
with closed-loop control forces is represented schematically in 
figure 2. Processors are provided by IMAT and accessed through an 
interactive menu-driven executive to transfer data between 
applications through a relational database. The IMAT database 
schema was developed specifically for storage and retrieval of finite 
element models, modes, frequencies, material properties, rigid-body 
inertia information, and other engineering information of interest in 
the definition of large space-based structures. For this reason, IMAT 
does not support a complete set of the elements and solution 
sequences in MSC/NASTRAN. For example, neither solid elements 
nor aeroelastic analysis is supported. The database for a given 
structure is managed by a commercial relational database manager 
code, Relational Information Management System (RIM), from Boeing 
Computer Services. 

Phase I. Structural Analysis 

The analyst develops a finite element model (e.g., using the 
SUPERTAB modeling code from Structural Dynamics Research 
Corporation) and stores the model in an IMAT-defined database. The 
analyst can then retrieve finite element information from the 
database, create an MSC/NASTRAN data deck, and perform an 
undamped modal analysis using Solution 3 of MSC/NASTRAN. The 
analyst will usually compute a number of modes and frequencies 
sufficient to describe the dynamic behavior range of interest by a 
modal analysis. The analyst saves the New Problem Tape for future 
use in the recovery of physical data and stores the modes and 
frequencies in the IMAT database. 

Phase II. Control Design and Analysis 

With the normal modes available, the linear system matrices which 
define the structure (plant) are generated in a condensed form using 
IMAT's interactive GENERATE LINEAR SYSTEMS MATRICES 
processor. This processor asks the analyst to select the modes of 
interest which will be used to represent the dynamics of the plant, to 
define modal damping values for each mode, to define sensor 
locations and type, and to define controller locations and type. 
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The system dynamic equations of motion are reformulated in full 
matrix form using the MATRIXx and SYSTEM_BUILD codes developed 
and marketed by Integrated Systems Incorporated. In general, 
MATRIXx and SYSTEM_BUILD are used for linear systems and 
nonlinear systems, respectively. Once a system is formulated, a user 
can modify the system by adding more dynamics and control gains 
or deleting some parts of the system in the MATRIXx and 
SYSTEM_BUILD codes. MATRIXx can also be used to generate control 
gains and investigate the stability of a linearized system by using 
Bode plots and eigenvalue solvers. 

Phase III. Simulation 

If proportional damping is assumed, the dynamic equations for the 
structure can be represented by a set of uncoupled modal equations; 
however, the equations become coupled with the introduction of 
feedback control forces (forces which depend on response 
measurements) and the addition of dynamic equations for the 
actuators and sensors. The coupled system dynamic equations, not 
readily solvable in MSC/NASTRAN, are recast by the GENERATE 
LINEAR SYSTEMS MATRICES processor into first order differential 
equations based on state-space variables and solved directly in 
either the time domain or the frequency domain using MATRIXx. 

The output solutions could be responses of physical measurements or 
modal coordinates, and the input matrix representing the external 
forces could be generated using MATRIXx commands. For nonlinear 
systems, SYSTEM_BU1LD can be used to solve the equations by 
choosing one of several available numerical integration algorithms 
based on the complexity of the dynamics and applied forces. 

Phase IV. Data Recovery 


After the controls analyst has completed the simulation using 
MATRIXx or SYSTEM_BUILD, the structural analyst uses 
MSC/NASTRAN to transform the modal solutions to physical output 
such as grid point displacements and element stresses. The physical 
data recovery procedure, illustrated in figure 3, requires three files - 
the Old Problem Tape from the Solution 3 normal modes analysis, the 
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modal solution matrix calculated by MATRIXx, and an MSC/NASTRAN 
Solution 31 transient analysis restart data deck (including the 
checkpoint dictionary). The Old Problem Tape contains a complete 
physical and modal description of the structure, including physical 
and material properties, and the matrix of eigenvectors used to 
transform modal coordinates to physical coordinates. It does not 
require any modifications prior to being used in the restart process. 
An IMAT processor converts the modal solution matrix that was 
calculated by MATRIXx to MSC/NASTRAN INPUTT4 format and 
constructs the complete MSC/NASTRAN data deck to be used in the 
physical recovery operations. The last section of this overview 
provides details of these IMAT processors and their input/output 
requirements. 

Integration of the controls and structures disciplines requires 
methods of organizing and transmitting data between analysts that 
reduce the probability of errors caused by poor communications 
IMAT uses relations in an IMAT database to store the information 
that the structural analyst requires to calculate physical quantities 
based on modal simulation results. The controls analyst enters the 
information interactively, using an IMAT processor, by describing 
the system, including modal damping ratios, time steps and length of 
time used in the simulation, and the modes that were used. 

Controller and sensor descriptions loaded during the control system 
definition phase, as well as applied load descriptions, are also stored 
in the database. The updated database contains the names of the 
MATRIXx/SYSTEM.BUILD files that contain the modal solution 
matrices and the applied load and controller force/torque time 
histories. 

The structural analyst uses an IMAT interactive processor to create 
the MSC/NASTRAN Solution 31 modal transient analysis restart data 
deck. In addition to user-supplied input, the processor retrieves 
data from the database and from files that are referenced in the 
database. The processor inserts a simple DMAP alter in the Executive 
Control Deck that forces MSC/NASTRAN to "jump" over the transient 
response calculations and read in the MATRIXx simulation results 
instead. The data recovery phase of Solution 31 then proceeds in the 
normal manner. The processor also customizes a DMAP alter that 
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edits the eigenvalue table and eigenvector matrix to ensure that the 
modes used in the data recovery phase are the same solution modes 
that were used in the simulation. This feature allows the controls 
analyst to select any combination of modes for the simulation. 

The Case Control Deck is assembled automatically except for the titles 
and the X, Y plot requests. The plot request package is created by a 
menu-driven procedure that interrogates the user to determine the 
information to be plotted and the format of the plots. 

The Bulk Data Deck for the restart contains the cards needed to 
define the loads, the modal damping ratios, the simulation times and 
time steps, and the vectors that are used to partition the eigenvalues 
and eigenvectors. All of the Bulk Data cards are created 
automatically by the processor. 

Utiliti Jb 

The I«AT software includes a set of database management and 
graphiqf utilities that facilitate inspection of database contents and 
analyst results. Database management processors allow a user to 
easily create or interactively inspect the contents of a database 
without using RIM commands. A separate menu selection allows a 
user experienced in the use of RIM to execute RIM directly. In 
addition, a means to unload a database (i.e., write the contents to an 
ASCII file) is provided. This feature enables a user to transfer all or 
part of^a database’s contents to any other computer. If the other 
computer has RIM software installed, a new database can be easily 
created by reading the unload file into RIM. 

IMAT provides a common interface for storing, retrieving, and 
displaying graphical information. The IMAT graphics system is 
based on Precision Visuals' device-independent DI-3000 software. 
IMAT’s graphics processors generate DI-3000 metafiles (device- 
independent plot files) from the plot files created by SDCR's I-DEAS 
software (e.g., SUPERTAB), MSC/NASTRAN, and MATRIXx. The 
metafiles may be displayed on a monochrome or color graphics 
terminal by using the DISPLAY METAFILE processor. Publication- 
quality X, Y plots such as time histories or Bode plots can be 
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? 


produced by using a processor that takes MSC/NASTRAN or 
MATRIXx data and generates a command file for use with Precision 
Visuals’ PicSure plotting program. 

Outline of Procedure 

The following sections consist of a brief outline, followed by a 
detailed step-by-step description of the IMAT solution procedure. 
Appendix B uses a numerical example to illustrate this procedure. 
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Step-by-Step Outline 1 


Step-by-step Outline of the Solution Procedure 
Phase I. Structural Analysis 

Step 1. Build structural model with SUPERTAB. 

Step 2 Run CREATE DATABASE processor to create 
database. 

Step 3. Run LOAD UNIVERSAL FILE to load finite element model data 
into database. 

Step 4. Run FORMAT BULK DATA to create MSC/NASTRAN data deck. 

Step 5. Run MSC/NASTRAN to calculate natural frequencies and mode 
shapes. Save Old Problem Tape, Punch File, and utility file 
containing rigid-body mass properties (default name 
FOR011.DAT). 

Step 6. Run LOAD ANALYSIS RESULTS to load frequencies, mode 
shapes, and rigid-body mass properties into database. 

Phase II. Control Design and Analysis 

Step 7. Use DEFINE CONTROL SYSTEM to store control system definition 
in database. 

Step 8. Run GENERATE LINEAR SYSTEMS MATRICES processor to create 
system matrices. 

Step 9. Run MATRIXx to calculate control gain matrix, assemble the 
plant matrix and store these matrices in a MATRIXx file. 

Step 10. Assemble closed-loop plant (A) matrix in MATRIXx. 

Step 11. Run MATRIXx to calculate closed-loop eigenvalues. 
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Phase III. Simulation 

Step 12. Generate a system matrix including disturbance matrix [E] in 

MATRIXx. (Nonlinear systems should be formulated and solved 
using SYSTEM_BUILD.) 

Step 13. Run MATRIXx to calculate transient response to the desired 
forcing function, e.g., an impulse load. Save modal solution 
(q, q, andq) and actuator and applied-load force/time histories in 
formatted MATRIXx files. 

Step 14. Use RECORD CONTROL SIMULATION to enter simulation 
information. 


Phase IV. Data Recovery 

Step 15. Run RECOVER PHYSICAL OUTPUT processor to create UHV 

(modal solution) file in MSC/NASTRAN INPUTT4 format and to 
create MSC/NASTRAN data deck (including plot requests). 

Step 16. Run MSC/NASTRAN using Old Problem Tape from normal modes 
solution and UHV (modal solution) matrix calculated by MATRIXx 
to obtain physical results. 
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Detailed Description of the Solution Procedure 

In order to solve the dynamic equations, three design techniques are 
applied - assume the structure may be represented as a linear elastic 
system, discretize the model by finite element techniques, and 
perform a modal analysis. The menu-driven IMAT process lends 
itself to a step-by-step breakdown from model development to 
controls and structures analysis. The individual steps are grouped in 
four phases - Structural Analysis, Control Design and Analysis, 
Simulation, and Data Recovery. Bold face type in the text refers to 
the interactive IMAT menu prompts. The numerical example 
presented in Appendix B illustrates an application of the procedure 
to a simple three-mass model with an active control system. 

Phase I. Structural Analysis 

Step 1. SUPERTAB model building 

Begin the session by constructing the model in response 
to menu queries (the test case is a 3-mass structure as 
shown in the Numerical Example section, connected by 
damped springs). From the SUPERTAB MENU, choose 
EXECUTE SUPERTAB/GEOMOD, choose the terminal 
type (e.g., T4014), establish a model file, and pick the 
desired units of weight and measure (NOTE: IMAT 
allows any consistent set of units that has mass, length, 
and time as the primary quantities). Now select the 
SUPERTAB (EA) option, get into PRE/POSTPROCESSING 
(P), and create the physical and material tables to 
describe: 
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a. modulus of elasticity 

b. Poisson’s ratio 

c. shear modulus 

d. rod cross-sectional area (for spring 
constants, k) 

e. mass data 

At this point, set up the nodes and elements of the 
model and assign them the appropriate physical and 
material properties. (NOTE: In the three-mass example 
problem in Appendix B, rod elements are used in place 
of springs which are not in the IMAT library. Modal 
damping is used instead of physical viscous dampers.) 
Write a Universal file before exiting from SUPERTAB. 

Step 2. CREATE DATABASE 

This process creates an empty database formatted with 
the IMAT schema. Beginning with the DATABASE 
MANAGEMENT MENU of IMAT, select CREATE 
DATABASE. The procedure follows logically from the 
menu prompts. At the end of the process, there will be 
three files in the current directory - dbnamel.DAT, 
dbname2.DAT, and dbname3.DAT, where "dbname" is the 
name of the IMAT database. These files are created with 
a DELETE protection that must be changed by the owner 
before they can be deleted. 
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Step 3. LOAD UNIVERSAL FILE 

Execute the LOAD UNIVERSAL FILE processor and 
input the name of the database created in step 2. This 
procedure loads finite element model data contained in 
the universal file into the IMAT database. At this point 
the user should use the IMAT processor called QUERY 
DATABASE to inspect the database contents or to 
obtain a printout of the database. 

Now the model is analyzed using MSC/NASTRAN 
(developed by the MacNeal-Schwendler Corporation) to 
compute its modes and frequencies. The IMAT Normal 
Modes Analysis Data Flow is illustrated in figure 4. 

Step 4. FORMAT BULK DATA 

First select the MSC/NASTRAN MENU from the 
FINITE ELEMENT ANALYSIS MENU. Using the 
FORMAT BULK DATA processor, the user provides a 
maximum frequency of interest and specifies the 
degrees of freedom (DOF) that are constrained on the 
GRDSET card (if there are less than six rigid-body 
degrees of freedom). An MSC/NASTRAN data file is then 
created containing a complete finite element description 
of the model. The data deck includes CASE and 
EXECUTIVE CONTROL decks for a Solution 3 Normal 
Modes analysis. 
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Step 5. EXECUTE MSC/NASTRAN 

From the MSC/NASTRAN MENU, select EXECUTE 
MSC/NASTRAN. Enter the name of the MSC/NASTRAN 
data deck, and select from the FILE OPTIONS MENU 
the SAVE RESULTING UTILITY FILES option. This 
feature allows the user to assign a name to the utility 
file associated with FORTRAN unit 1 1 (default name is 
FOR011.DAT). The utility file will contain binary output 
from MSC/NASTRAN's Grid Point Weight Generator. 

This is the rigid-body mass-property data that is loaded 
into the RIGPROP relation in the IMAT database (see 
step 6). Eigenvalues, eigenvectors and the Checkpoint 
Dictionary (used later for restart) are saved in the 
PUNCH file called "name.PCH", where "name" is the name 
of the MSC/NASTRAN data deck. 

Step 6. LOAD ANALYSIS RESULTS 

This procedure takes MSC/NASTRAN analysis data from 
the PUNCH file and utility file and loads it into the 
database created in step 2. Choose FINITE ELEMENT 
ANALYSIS from the IMAT menu followed by 
MSC/NASTRAN MENU and LOAD ANALYSIS 
RESULTS. The output data is added to the database - 
that is, vibrational eigenvector and frequency data 
(contained in the punch file) and rigid-body mass 
properties (contained in the utility file). The analyst 
should now use QUERY DATABASE (under the 
DATABASE MANAGEMENT MENU) to carefully 
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inspect the database contents, especially the EIGNVALS, 
EIGNVECT and RIGPROP relations. An additional file 
(default name "dbname.EGN") is created. This is a 
rapid-access binary file that contains the eigenvector 
data. It is used by the GENERATE LINEAR SYSTEMS 
MATRICES (see step 8) and the QUERY EIGENVECTOR 
FILE processors. 

Phase II. Control Design and Analysis 

Step 7. DEFINE CONTROL SYSTEM 

From the CONTROLS MENU, select DEFINE CONTROL 
SYSTEM and enter the actuator, sensor and applied 
force (disturbance) information for the model. 
Additionally, the user must specify which modes are to 
be used, the damping coefficients for each mode, and 
the system description for the control model — this is 
essential in the next step. 

Step 8. GENERATE LINEAR SYSTEMS MATRICES 

From the CONTROLS MENU, select GENERATE 
LINEAR SYSTEMS MATRICES and enter the name of 
the controls database, identifying the particular system 
that will be used in the analysis. From this data the A, 

B, C, and E matrices are generated. The plant matrix [A] 
and the control influence matrix [B] specify the linear 
system completely so that the dynamics and stability of 
the model can be determined by investigating these 
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matrices. The observation matrix [C] contains 
information relating physical output to the state vector. 
The disturbance matrix [EJ can also be created for use in 
the simulation phase. The matrices are written in 
compressed form to a formatted file that can be read by 
MATRIXx. A DATA PRINT FILE can also be generated so 
that the user can visually inspect the matrices. 

Step 9. Run MATRIXx to calculate control gain matrix 

Run EXECUTE MATRIXX to load the linear system 
matrix tile and set up the plant matrix. MATRIXx can 
also be used to compute control gains via an appropriate 
control law. Modern control theory (time domain) is 
used in the example problem in Appendix B to establish 
a control law that minimizes a specified performance 
index. Store the newly created control gain matrix and 
plant matrix in a MATRIXx file. 


Step 10. Create the closed-loop plant (A) matrix in MATRIXx 

Assemble the control gain and plant matrices and set up 
the system for closed-loop analysis without accounting 
for the disturbance forces. 
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Step 1 1 Compute closed-loop eigenvalues in MATRIXx 

Now that the closed-loop |A] matrix is created, run 
MATRIXx and compute the closed-loop system 
eigenvalues to determine the stability of the system. 
System stability can also be investigated by using 
MATRIXx to generate information such as Bode plots. 
Store this information in a MATRIXx file. If the system 
is stable, move on to the simulation phase. 

Phase III. Simulation 

Step 12. Generate system matrix, including MATRIXx 

Now that the matrices have been assembled in 
MATRIXx, the user can perform a simulation for a given 
input function, such as a unit impulse load. The closed- 
loop system now must include the E matrix. (NOTE: 
SYSTEM_BUILD, found within MATRIXx, is a valuable 
tool for building block diagrams of feedback control 
systems. The procedure will not be shown here, but it 
• is available in the IMAT process.) 

Step 13. Calculate transient response to impulse load 

Compute the response of the system to a disturbance by 
performing a simulation in MATRIXx. Use MATRIXx to 
write three separate formatted files (i.e., use FSAVE) for 
modal displacement, velocity and acceleration. All files 
should be written such that each column of the vector 
or matrix represents a time step and each row 
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represents a structural mode. A separate file must also 
be generated for each controller force and disturbance 
force. 

Step 14. RECORD CONTROL SIMULATION 

Select the CONTROLS MENU and execute the RECORD 
CONTROL SIMULATION processor to store the 
information pertaining to the simulation. This 
information includes the names of the files generated in 
the previous step. The RECOVER PHYSICAL OUTPUT 
processor uses this data to create a complete 
MSC/NASTRAN modified-restart data deck. 

Phase IV. Data Recovery 

Step 15. RECOVER PHYSICAL OUTPUT 

Enter the CONTROLS MENU of IMAT and select the 
RECOVER PHYSICAL OUTPUT option. This processor 
reads the modal (state-space) solution calculated by 
MATRIXx and converts it to a form that can be read by 
MSC/NASTRAN. The RECOVER PHYSICAL OUTPUT 
processor also creates a complete MSC/NASTRAN data 
deck that is used to calculate desired physical output 
quantities such as nodal displacements or element 
stresses. The processor allows the user to interactively 
select the inlormation to be plotted and generates 
appropriate XYPLOT commands. 
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Step 16. Run modified MCS/NASTRAN Solution 31 to get physical 
output 

Run MSC/NASTRAN using the Old Problem Tape from 
the normal modes solution, the UHV (modal solution) 
matrix file created in step 15, and the MSC/NASTRAN 
data deck created in step 15. The UHV matrix file must 
be assigned to FORTRAN unit 15 prior to MSC/NASTRAN 
execution. 
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Description of Data Recovery Processors 

Two processors are employed in using MSC/NASTRAN to recover 
physical output from a state-space time simulation calculated using 
MATRIXx or SYSTEM_BUILD as shown in figure 3. A description of 
each processor follows. 

RECORD CONTROL SIMULATION: This interactive program allows the 
user to enter a record of one closed-loop simulation into the IMAT- 
defined database which contains the structural and control data for 
the model. This information is necessary for the RECOVER PHYSICAL 
OUTPUT processor when generating an MSC/NASTRAN bulk data deck 
to obtain displacements or stresses. The data items requested by the 
program in order to create a record of a control simulation include the 
name of the analyst, date of the analysis, the simulation times, and 
related modal output and time history file names. The program will 
also allow the user to examine and make changes to previous control 
simulation records as needed. 

RECOVER PHYSICAL OUTPUT: This program reads the MATRIXx or 
SYSTEM_BUILD modal simulation results and creates an 
MSC/NASTRAN UHV (modal solution) matrix. A binary file is used for 
the UHV matrix to conserve disk space due to the anticipated size of 
these files and also to take advantage of the significant performance 
advantage of using a binary structured file. The RECOVER PHYSICAL 
OUTPUT program also allows the structural dynamicist during an 
interactive menu-driven terminal session to create the 
MSC/NASTRAN Executive, Case Control, and Bulk Data Decks required 
to recover physical results from the closed-loop simulation. The 
program uses the information stored in the database by the controls 
analyst to locate the load time history files. It also extracts the 
modes, damping ratio, and time step interval used in the simulation 
from the database. 

Creation of the Executive Control Deck: As a precaution, the RECOVER 

PHYSICAL OUTPUT processor compares the number of structural 
modes used in the MATRIXx/SYSTEM_BUILD simulation with the 
number of modes stored in the IMAT database, and alerts the analyst 
to any discrepancies. It then creates the Executive Control Deck 
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which includes alters which will tailor the execution of 
MSC/NASTRAN to read in the state-space solution from 
MATRIXx/SYSTEM_BUILD files (See figure 5): 

1 . ALTER 455 is used to remove the structural modes not used by the 
controls analyst from the solution. 

2. ALTERS 479 and 480 are used to skip MSC/NASTRAN’s transient 
analysis calculations and substitute a UHV (modal solution) matrix 
that has been calculated by the controls code, MATRIXx or 
SYSTEM_BUILD. 

The checkpoint dictionary is extracted from the punch file created by 
the original MSC/NASTRAN normal modes analysis and inserted into 
the Executive Control Deck. 

Creation of the Case Control Deck: The RECOVER PHYSICAL OUTPUT 
processor initializes the Case Control Deck including title information 
entered by the structural dynamicist and allows the analyst to set 
plot parameters such as paper size, axis specifications, and scaling. 

The program then provides for automated generation of plot 
commands for dynamic load plots, modal and physical displacement, 
velocity, and acceleration plots, and element force and stress plots 
through a menu-driven interface. 

Creation of the Bulk Data Deck: The RECOVER PHYSICAL OUTPUT 
processor completes the MSC/NASTRAN data deck by generating the 
TLOAD, DAREA, and TABLED 1 cards required for each dynamic load. 
DMI cards are written to generate the partitioning vectors that are 
used to remove modes from the analysis. 

The recovery of physical output for the closed-loop simulation is 
completed with the execution of MSC/NASTRAN using the data deck 
and the UHV matrix file created by the RECOVER PHYSICAL OUTPUT 
processor, as well as the Old Problem Tape (OPTP) from the normal 
modes analysis. 
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Figure 2 IMAT process for the simulation of actively controlled flexible structures 
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Figure 3 Physical data recovery 
procedure 













ID TRANSIENT ANALYSIS, IMAT ALTERS 
SOL 31,0 
COMPILER = LIST 
S 

$$$S$$$$$S$SS$$$$$$$$$$$$$$$$$$$S$$$$$$$$$$$$$$$$$S$$$$$$$$$$$$$$$$$$$S$ 


$ S 

S THE FOLLOWING ALTER IS USED TO SKIP MSC/NASTRAN'S TRANSIENT ANALYSIS $ 

S CALCULATIONS AND SUBSTITUTE A "UHV" (MODAL SOLUTION) MATRIX THAT $ 

$ HAS BEEN CALCULATED BY A CONTROLS CODE (E.G..MATRIXX). THE S 

S PROCEDURE ALLOWS A CLOSED LOOP TRANSIENT ANALYSIS MODAL SOLUTION S 

S TO BE READ INTO MSC/NASTRAN USING THE "INPUTT4" UTILITY MODULE. THE S 

S MSC/NASTRAN SOLUTION SEQUENCE IS THEN USED TO OBTAIN PHYSICAL OUTPUT $ 

$ SUCH AS DISPLACEMENTS OR STRESSES FROM THE CLOSED LOOP MODAL $ 

S SOLUTION $ 

$ TWO ADDITIONAL DATA FILES MUST BE USED IN THE EXECUTION OF THIS $ 

S MODIFIED SOLUTION SEQUENCE. $ 

S $ 

s 1) THE "NEW PROBLEM TAPE" CONTAINING THE MODE SHAPES AND $ 

S FREQUENCIES CALCULATED BY MSC/NASTRAN SOLUTION 3 MUST S 

S BE ASSIGNED AS "OLD PROBLEM TAPE" (OPTP) FOR THE RESTART. S 

S s 

S 2) THE CONTROLS-CODE-GENERATED MODAL SOLUTION MATRIX MUST $ 

S BE ASSIGNED AS FORTRAN UNIT "FOR015" (FOR015 IS ASSUMED TO BE $ 

S A FORTRAN READABLE BINARY FILE.) $ 

S s 

$$sssss$s$sssss$sss$ssssssss$s$sssssss$s$$s$s$s$$ss$$s$$$$s$$$$$$$$s$ss$ 

S s 

SS$SSS$$ ALTER TO REMOVE USER SELECTED MODES FROM SOLUTION SET SSSSSSSS 

s s 

S SUMMARY OF MODES USED IN CLOSED LOOP SIMULATION $ 

S (0 = UNUSED 1 = USED) S 

$ ORIGINAL MODES CALCULATED: 26 S 

S $ 

$12 $ 

$ 12345678901234567890123456 S 

S $ 

S 000000 1111111111 0000000000 s 

s $ 

ALTER 455 $ 

LAMX EM AT,L AM A/LAMB/ 10 SELIMINATE UNWANTED FREQUENCIES&REORDER TABLES 
EQUIV LAMB.L AM A/TRUE S $ 

PURGE MI/ALWAYS S $ 

S $ 

PARTN PH1A,CP,/A11,A21,A12,A22/1 S PARTITION EIGENVECTOR MATRIX (A-SET) $ 

EQUIV A11,PHIA/TRUE S $ 

s S 


Figure 5 Example of modified MSC/NASTRAN Solution 31 Executive 

Control Deck 
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SSSSSSSS ALTER TO SUBSTITUTE CONTROLS-CODE-GENERATED MODAL SOLUTION $$$ 
S $ 

ALTER 479 S SKIP MODULE TRD1 (TRANSIENT ANALYSIS) $ 

JUMP SKIPTR $ 

ALTER 480 $ 

LABEL SKIPTR $ 

S " 

$ 

INPU IT4/UHV,,,,//] 5/-1/1 $ READ UHV MATRIX FROM FOR015 $ 

S S 

ENDALTER 

S s 

SSSSSSSSSSSSSSS END OF TRANSIENT ANALYSIS ALTER $$$$$SS$$S$$$$$$$$$S$$$$ S 

S S 

TIME 500 

DIAG 8,16 

RESTART BAILEY .ZBORB1 ,10/ 8/87, 44192, 

1, XVPS , FLAGS = 0, REEL = 1, FILE = 5 

CHECKPOINT DICTIONARY. 

257, XVPS , FLAGS = 0, REEL = 1, FILE = 126 

S 

S END OF CHECKPOINT DICTIONARY 
CEND 


Figure 5 concluded 
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INTRODUCTION: 

The IMAT EXECUTIVE is a program that allows the user to access and 
execute IMAT processors by means of a menu format. At the bottom 
of each menu in the IMAT EXECUTIVE is an option line which 
contains the additional commands defined below. These same 
commands can be found in the menus of the individual IMAT 
processors and will perform the function indicated in any menu 
which offers them. 


COMMANDS USED THROUGHOUT IMAT: 

H Help Display helpful information on the current problem. 

M Menu In the IMAT EXECUTIVE - return to the MAIN MENU. 

In most IMAT processors - redisplay the current menu. 

V VMS Enter an operating system (DCL) command. 

Q Quit Leave the IMAT EXECUTIVE or terminate the current 
processor. 

<CR> Return Select default option (see below). Return to the previous 
menu of the current processor if using the IMAT 
EXECUTIVE. 

[ 1 Default Indicates the option selected as default chosen 
by entering <CR> alone. 

!!! Errors Error messages to the user are marked by either of 
«< »> these symbols. 
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PROCESSOR: IMAT EXECUTIVE 

PURPOSE: The IMAT EXECUTIVE permits users to select and 

execute the IMAT utilities and processors from a tree-like menu 
structure. 


DISPLAYING HELP INFORMATION TO A NEW USER: 

When you first enter the IMAT EXECUTIVE you will be shown the 
INTRODUCTORY MENU: 


IMAT EXECUTIVE: USER TYPE MENU 


1 . EXPERIENCED USER. 

2. NEW USER. DISPLAY INFORMATIVE MESSAGES. 
ENTER SELECTION: 1 -2, Q OR FOR HELP ENTER ? 


Enter option 1 if you are familiar with the system, or option 2 to see 
a summary of the commands used in IMAT. The following command 
options are presented in the prompt following each menu: 

ENTER SELECTION: (1-4, H, M, Q, V) 


These commands are explained in the IMAT COMMANDS section of 

the USER'S GUIDE. Local help may be accessed at any menu by 
entering H. 


UPPER/LOWERCASE INPUT: 

The EXECUTIVE will put your terminal into uppercase mode as you 
enter IMAT and return you to your previous case setting upon exit 


EXECUTIVE 


2-2 



EXECUTIVE 2 


PROCESSOR SUMMARIES: 

A brief summary of each processor and utility follows. Consult the 
documentation for the individual processor for a more detailed 
explanation. 


I. DATABASE MANAGEMENT 

1. CREATE DATABASE: will generate a new IMAT-defined RIM 
database containing supported IMAT relations. 

2. QUERY DATABASE: will assist you in inspecting the contents of a 
database. No experience with RIM commands is required. 

3. UNLOAD DATABASE: will unload a RIM database to a text file for 
transfer to other computer systems. 

4. EXECUTE RIM: will require you to communicate directly with the 
RIM system. You should be conversant with RIM commands 
before selecting this option. 


II. GRAPHICS 


1 . GENERATE METAFILE: will convert picture files from several 
sources (SUPERTAB, GEOMOD, MATRIXx) to a vector or raster 
metafile. 

2. DISPLAY METAFILE: will allow you to view metafiles using the 
Metafile Translator. 

3. GENERATE PICSURE COMMAND FILE: will generate a command file 
for PicSure to create plots from MATRIXx and MSC/NASTRAN. 
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4. EXECUTE PICSURE: will execute the PicSure graphics system. This 
processor allows you to interactively create charts or graphs and 
save them as metafiles. 

5. HARDCOPY METAFILES (for LaRC use only): will generate the 
output of DI-3000 metafiles and Raster Metafile format files on 
ACD production plotters. 


III. FINITE ELEMENT ANALYSIS 

A. MSC/NASTRAN 

1 LOAD BULK DATA: will load a file of MSC/NASTRAN bulk data 
into an IMAT database. 

2. FORMAT BULK DATA: will format a MSC/NASTRAN bulk data 
deck from finite element model data stored in an IMAT 
database. 

3. EXECUTE MSC/NASTRAN: will run MSC/NASTRAN using a bulk 
data deck generated by option 2 (or any MSC/NASTRAN bulk 
data deck). 

4. LOAD ANALYSIS RESULTS: will load a file of MSC/NASTRAN 
analysis data into an IMAT database. 

5. RECOVER PHYSICAL OUTPUT: will recover physical output using 
MSC/NASTRAN from a state-space time simulation calculated 
using MATRIXx. 

B. SUPERTAB 

1 . EXECUTE SUPERTAB/GEOMOD: interactively executes SDRC I-DEAS 
SUPERTAB or GEOMOD. 

2. LOAD UNIVERSAL FILE: will load finite element model data from 
an I-DEAS universal file into an IMAT database. 
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3. FORMAT UNIVERSAL FILE: will generate an I DEAS universal file 
from finite element model data stored in an IMAT database. 


IV. CONTROLS 

1. DEFINE CONTROL SYSTEM: allows you to interactively edit your 
database to enter or modify control system information. 

2. GENERATE LINEAR SYSTEMS MATRICES: generates a MATRIXx file 
containing the linear systems matrices from a control system 
defined in an IMAT database. 

3. EXECUTE MATRIXX: interactively executes MATRIXx 
/SYSTEM_BUILD with a choice of memory size. 

4. RECORD CONTROL SIMULATION: allows you to interactively edit 
your database to enter the specifics of a controls simulation. This 
information will be required before recovering physical output 
(MSC/NASTRAN MENU). 

5. QUERY EIGENVECTOR FILE: allows you to examine the eigenvector 
file created by the LOAD ANALYSIS RESULTS processor 
(MSC/NASTRAN MENU). 
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Database Overview 1 


The Relational Information Management System (RIM) developed by Boeing 
Computer Services is the information manager used by IMAT. IMAT has a 
maintained RIM database definition or schema which contains 27 relations 
and 158 attributes at the present time. The relations and attributes are 
described in APPENDIX A. A maintained schema ensures that information 
may be shared by the IMAT users. 

A relational database stores data as a collection of two-dimensional tables 
called relations. A relation consists of rows, sometimes called tuples, and 
columns called attributes. A row represents an occurrence of a group of 
attributes. Attributes may be of different types - text, integer, real, vector, 
matrix, date, and time. Attributes names may appear in more than one 
relation. 

When RIM creates a database, it generates three files. The database name 
may contain up to six alphanumeric characters. To this RIM will add a suffix 
of 1, 2, or 3. If a database is named DBNAME, then the database files are 
DBNAME1.DAT, DBNAME2.DAT, and DBNAME3.DAT. DBNAME1.DAT contains 
the schema which describes the database structure. DBNAME2.DAT is the file 
which has the actual data for each relation and DBNAME3.DAT has index 
pointers. The CREATE DATABASE processor will create an empty IMAT- 
defined database for you. 

The RIM database may be written to an ASCII file for transfer to other 
computer systems. This is called unloading the database. An IMAT 
processor, UNLOAD DATABASE, will unload your database for you. 

If you would like more information about RIM, consult RIM - RELATIONAL 
INFORMATION MANAGEMENT SYSTEM USER’S MANUAL, 1985, The Boeing 
Company. 
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PROCESSOR: CREATE DATABASE 

PURPOSE: This processor will create an IMAT-defined RIM 

database. The name of the database is chosen by the user. 

THE RIM DATABASE: 

The password for the RIM database will be set to NONE, and the 
database will contain all of the standard relations required for IMAT. 
The database will be created with delete protection to avoid 
accidental deletion. If you want to delete the database, you must 
reset the protection on each of the three database files. For example, 
the command, SET PROTECTIONS :R WED) DBNAME%.DAT will reset 
the protection for database DBNAME. 

ENTERING THE DATABASE NAME: 

The program will ask you to enter a name for your database. The 
name may be no longer than six characters, and must begin with an 
alphabetic character. The name may not have embedded blanks. If 
the database name you enter is invalid, the program will give you a 
chance to enter a different name. The program will not allow you to 
overwrite a database of the same name in your directory. It will 
inform you that a database of that name exists and give you the 
choice of either entering a different name or exiting the processor. 

ENTERING THE DATABASE DESCRIPTION: 

In addition to entering a name for the database, you must also 
supply the information for the database description relation DBDESC. 
You will be asked to enter the following information: 

1 . The name of the project. 

2. The name of the person responsible for the database. 

3. The phone number where the responsible person can be reached. 

4. A brief description of the database. 
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5. The type of units used. The units may be any consistent 
system whose primary physical quantities are mass (M), 
length (L), and time (T). 

The values that you enter will be added to the relation DBDESC when 
the database is created. 
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PROCESSOR: QUERY DATABASE 

PURPOSE: The QUERY DATABASE processor allows the user to 

inspect the contents of a RIM database without having to know RIM 
commands. 

SELECTING A DATABASE: 

When you first enter the QUERY DATABASE processor, you will be 
prompted to enter the name of the database you wish to inspect. If 
your database is not in the current directory, the program can access 
your database from another directory as long as you have "read" 
permission to the database files. Enter the pathname to the directory 
where the database files are located: 

EX: DUAO:[YOURDIR.YOURSUBDIR] 

SELECTING AN OUTPUT MODE: 

The QUERY DATABASE processor will now present the OUTPUT MODE 
MENU: 

QUERY DATABASE: OUTPUT MODE MENU 
ENTER OUTPUT MODE DESIRED: 

1. TERMINAL OUTPUT ONLY 

2. TERMINAL OUTPUT PLUS LOG FILE 

3 . LIST DATABASE CONTENTS TO TEXT FILE 

4 . RETURN TO DATABASE ENTRY PROMPT [DEFAULT] 

CURRENT LOGFILE: NONE 

CHANGE: D-DATABASE ... OR 
ENTER SELECTION: (1 - 4, H, M, Q, V) 
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Choose option 1 if you would like all output go to the terminal screen 
only or option 2 to have a log file generated in addition to screen 
output. The log file will have the name of your DATABASE.LOG and 
will first contain a listing of all the relations in the database, and the 
schema and data from any relations you inspect. A log file will only 
contain data from one database. If you choose to look at a different 
database from any point in the program (at this menu - either by 
choosing option 4 or D from the options line at the bottom of the 
menu), the log file will be closed and you will have the option of 
opening a new log file from this menu. 

If you currently have an open log file when you see this menu, an 
alternate set of options is presented: 

QUERY DATABASE: OUTPUT MODE MENU 

ENTER OUTPUT MODE DESIRED: 

1. TERMINAL OUTPUT ONLY 

2. TERMINAL OUTPUT - OPEN NEW LOG FILE 

3. TERMINAL OUTPUT - CONTINUE CURRENT LOG FILE 

4. LIST DATABASE CONTENTS TO TEXT FILE 

5 . RETURN TO DATABASE ENTRY PROMPT [DEFAULT] 

CURRENT LOGHLE: YOURDB.LOG;l 

CHANGE: D-DATABASE ... OR 
ENTER SELECTION: (1 - 4, H, M, Q, V) 

From this alternate OUTPUT MODE MENU you may either continue with the 
same log tile for this database (option 3) or close the current log file and open 
a new one (option 2). 
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Option 3 (LIST DATABASE CONTENTS TO TEXT FILE - This is option 4 in the 
alternate menu) will generate a file which contains a full listing of the schema 
and contents of your database. If you select this option, you will be prompted 
to enter a name for your listing file, and to select 80 or 132 column width for 
your output, whether you want to include the schema for empty relations, 
and whether you want the listing generated interactively or submitted as a 
batch job. If the database contains a large amount of data (a relation with 
over 2000 rows), it would be better to submit this as a batch job. 

NOTE: To prevent any conflict with your currently opened database, 

this batch job will be submitted with a one-hour delay. You can 
change the execution time by issuing the DCL command "SET QUEUE 
/ENTRY=xxx /AFTER=xxx SYS$BATCH". Consult VMS on-line help for 
the specifics of this command. 

SELECTING A RELATION: 

Once you have selected an output mode, the QUERY DATABASE 
processor will present a menu of the relations (tables) in your 
database: 

QUERY DATABASE: "YOURDB" RELATIONS MENU 


RELATION 

ATTRIBUTES 

ROWS 

1. ACTUATOR 

4 

4 

2. BEAMPROP 

1 2 

6 

3. BEAMREF 

5 

22 

4. BEAMS 

5. ... 

1 7 

174 

[MOREJ ENTER <CR> TO CONTINUE 

...OR 


CHANGE: D-DATABASE O-OUTPUT ... OR 
ENTER SELECTION: (1 - 14, H, M, Q, V) 

Choose one database relation at a time to inspect. If you see the 
prompt: [MORE], your database contains more relations than appear 
on the screen. Enter a <CR> if you would like to see these additional 
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relations. Additional 

commands available directly from this menu 

are: 

M - 

to return to the top of the RELATION MENU 

D - 

to select a new database 

0 - 

to return to the the OUTPUT MODE MENU to 
select a new output mode 


SELECTING ATTRIBUTES: 


Once you have selected a relation, the QUERY DATABASE processor 
will present a menu of the attributes (data items) in the relation. 
This menu will give the name of each attribute, its data type, units, 
and if available, a description of the attributes. The following data 
types may be present: 


integer 

V 5 - 

5-element vector 

real 

VV - 

variable length vector 

date 

T8 - 

8-character text 

4x5 matrix 

TV - 

variable length text 


MV - 

variable length matrix 


Enter an A if you want to see all the attributes in a relation, or 
separate individual selections with a comma. You may use a dash to 
indicate a range (EX: 1, 3-5, 9 ). If more than one screen must be 
used to display all of the attribute choices for a relation, the program 
will ask you to choose attributes from all screens for the relation 
before actually retrieving any data. 


Additional commands available directly from the ATTRIBUTES MENU 
are: 


to return to the top of the ATTRIBUTE MENU 

to select a new database 

to return to the the OUTPUT MODE MENU to 

select a new output mode 

to select a new relation 

toggles on and off the program option to 

qualify data retrieval using a RIM WHERE 

condition (See Below). 
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QUALIFYING THE DATA ITEMS YOU SELECT: 


You may not wish to see all rows in your relation but may want to 
select only certain rows that meet a specific qualification (e.g., a data 
item greater than 100). The QUERY DATABASE processor provides a 
WHERE option to allow you to do this. You may turn this option ON 
or OFF at any time by entering a W at the ATTRIBUTES MENU. 

When you first enter the QUERY DATABASE processor, the WHERE 
option is turned ON. Unless you immediately turn this option OFF, 
the first time you complete a choice from the ATTRIBUTES MENU, the 
program will present a help screen with a summary of the WHERE 
commands. (In future executions, you may want to set the WHERE 
option to OFF to prevent the display of this help screen.) 

When the WHERE option is ON, the program will prompt you to enter 
up to five RIM condition clauses to further qualify the data items you 
select. The following RIM data qualification clauses are supported by 
this processor: 


COMMAND (ATTi & ATT2 ARE COLUMNS) SELECTS ROWS WHERE 


WHERE... 


ATTI EXISTS ATTI 

ATTI FAILS ATTI 

ATTI EQ 3 (ALSO: NE.GT.GE.LT.LE) ATTI 

ATTI EQS "JONES"(ALSO:NES,CONTAINS) ATTI 
ATTI EQA ATT2 (ALSO:NEA,GTA,LTA,LEA) ATTI 
ROWS EQ 1,3,5 (ALSO: NE.GT.GE.LT.LE) ROW 


HAS A VALUE 
HAS NO VALUE 
EQUALS 3 

EQUALS SUBSTRING "JONES" 
EQUALS ATTRIBUTE ATT2 
NUMBER EQUALS 1,3,5 
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NOTE: EQ (equals), NE (not equals), GT (greater than), GE (greater than 
or equal), LT (less than), LE (less than or equal), EQS (equals 
substring), NES (not equal substring), CONTAINS (contains substring), 
EQA (equals attribute), NEA (not equal attribute), GTA (greater than 
attribute), GEA (greater than or equal to attribute), LTA (less than 
attribute), LEA (less than or equal attribute). 

Be certain to enclose your comparison value in double quotes and use 
the operators EQS, NES, or CONTAINS, when selecting text attributes. 
Enter one clause at a time when the QUERY DATABASE processor 
prompts you: 

CONDITION CLAUSE # 1: ... OR H -HELP A-ATTRIBUTES S-STOP 
[<CR>NONE] 


For example, you might enter: 

NODENUM EQ 100 

Also at this prompt you may enter A to get a brief listing again of the 
attributes in the current relation, H to see the help screen again, or S 
to return to the ATTRIBUTE MENU to enter a different list of 
attributes desired (or to return to the RELATION MENU, etc.). A <CR> 
at this point will end your entry of condition clauses. (If this is the 
first condition clause, this would be the equivalent of entering no 
WHERE condition at all. 

After each condition clause you enter (for the first 4 clauses), the 
program will present the prompt: 

ANOTHER CONDITION? ENTER: OR/AND/[NONE] 

Enter the Boolean value OR or AND if you wish to make a multiple 
clause qualification (i.e. where NODENUM GT 10 AND NODENUM LT 
100), or a <CR> to end the condition clause input. 
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DISPLAYING THE DATA: 

The QUERY DATABASE PROCESSOR will now display the data you 
have selected one screenful at a time, followed by the prompt: 

MORE ... CONTINUE ? [Y]/N 

Enter a <CR> to continue or N to return to the ATTRIBUTES MENU if 
you want to stop the data display. In general, depending on the data 
types, approximately seven attributes will fit on a screen. If you 
have selected more than seven attributes, the program will show you 
data for the first seven attributes chosen before going on to the 
remaining attributes selected. The program will return you to the 
ATTRIBUTES MENU after displaying all the data you have chosen. 

NOTE: The QUERY DATABASE processor may be very slow when 
inspecting extremely large relations - in particular, the IMAT 
relation, EIGNVECT (eigenvectors). Use the QUERY EIGENVECTOR FILE 
(CONTROLS MENU), to look at eigenvectors. 

EXITING THE PROCESSOR: 

Enter a Q at any menu offering it to exit the QUERY DATABASE 
processor. If you have requested a log file, it will be in your default 
directory when you exit the IMAT EXECUTIVE. If you have 
requested a batch-mode database listing, the QUERY DATABASE 
processor will inform you of any other files you should expect to see. 
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PROCESSOR: UNLOAD DATABASE 

PURPOSE: The UNLOAD DATABASE processor permits users to 

unload a RIM database to an ASCII text file which may be 
transferred to other computer systems. The unload function may be 
executed interactively or submitted to a queue for execution in a 
batch environment. 

ENTERING THE NAME OF THE DATABASE: 

You will be asked to enter the name of the database that you want to 
unload. If the database is not in your current directory, you will be 
asked to supply the full pathname of the directory where the 
database is located. The processor will make a temporary copy of 
the database in your current directory and will delete it upon 
completion. 

SELECTING RELATIONS: 

After a database is selected, you will be presented with a menu of 
submission types available. You may select BATCH, INTERACTIVE, or 
TERMINATE. TERMINATE is the equivalent of entering a Q (quit). 
Selecting INTERACTIVE will cause the RIM unload to begin 
immediately and you must wait for its completion. This may require 
30 minutes or more depending on computer activity and database 
size. Selecting BATCH will submit a job to the SYS$BATCH queue for 
execution in a batch environment. 

TERMINATION: 

When you have completed your session with UNLOAD DATABASE 
and elect to quit, all files you have generated will remain in your 
current directory. You will then be returned to the IMAT EXECUTIVE. 
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PROCESSOR: EXECUTE RIM 

PURPOSE: This processor allows the user to access the standalone 

version of Boeing RIM (Relational Information Management) from 
the IMAT EXECUTIVE. 

You must be familiar with RIM commands to use the standalone 
version. By executing RIM directly, you will be able to modify or 
examine the data in the database, protect the data by adding 
passwords to specific relations or to the entire database, and create 
new relations from existing relations. For a discussion of RIM 
commands consult the RIM USER’S MANUAL. 
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Device-independent display format, which is 
composed of positioning (move, draw) and 
non-positioning (color, etc.) commands, 
providing a universal method for the transfer 
of graphical images between vector display 
devices. 


Device-independent display format 
consisting of an image header, which 
describes the image format, and opcodes, 
which are used to delineate entities (run- 
lengths, pixel values, color maps, intensity) 
within the image structure, providing a 
method for the transfer of graphical images 
between raster-oriented devices. 
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PROCESSOR: GENERATE METAFILE 

PURPOSE: The GENERATE METAFILE processor provides the IMAT user 

with the ability to translate package specific graphics output into device- 
independent metafile format. Allowable package specific output includes: 
I-DEAS, MSC/NASTRAN, and MATRIXx. This processor converts the 
graphics output into vector or raster metafile format. 

When the GENERATE METAFILE processor is invoked, the following menu 
will be displayed: 

GENERATE METAFILE: TRANSLATOR MENU 

1 . I-DEAS 

2. NASTRAN 

3. MATRIXX 

4 . EXIT TO PREVIOUS MENU [DEFAULT] 

This menu allows you to select the type of graphics output data you wish 
to have processed. 

TRANSLATOR MENU OPTION 1: I-DEAS 

This option will process I-DEAS picture file data. This data may be of 
vector or raster/shaded data type and you should be aware of the data 

format of your file. Upon selection of option 1 the following menu will be 
displayed: 

I DEAS METAFILE: DATA TYPE MENU 

1 . VECTOR DATA 

2. RASTER DATA (512 X 512) 

3. RASTER DATA (1024 X 1024) 

4. RASTER DATA (2048 X 2048) 

5 . EXIT TO PREVIOUS MENU [DEFAULT] 
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Option 1 (VECTOR DATA) of the I-DEAS METAFILE MENU will process 
I-DEAS vector data into a DI-3000 metafile format. You will be asked to 
enter the name of the file containing the I-DEAS vector data. 


ENTER THE NAME OF THE FILE CONTAINING THE I DEAS VECTOR 
PICTURE DATA: 

(ENTER FULL PATHNAME IF FILE IS NOT IN CURRENT DIRECTORY.) 
You will then be prompted to enter the file type. 

I DEAS METAFILE: FILE TYPE MENU 

1 . BINARY FORMAT [DEFAULT] 

2. FORMATTED 

You must enter the format of the data file that is being processed. This 
format selection was made within I-DEAS when picture output was 
activated. The next question within the processor relates to the SDRC 
header information placed by default on all graphics output within 
IDEAS. 

DO YOU WISH TO HAVE THE SDRC HEADER 
INFORMATION INCLUDED WITH YOUR PICTURE ? 

ENTER SELECTION: H, Y OR [N] 

Selecting N (the default) will remove the SDRC header information from 
the final output written to the metafile. The final question regards the 
name of the metafile. 

ENTER VAX METAFILE NAME: 

You will then be asked if you wish to process another vector data file. 
PROCESS ANOTHER I DEAS VECTOR FILE ? 

ENTER SELECTION: H, Y OR [N] 
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Entering N (the default) will return you to the I-DEAS METAFILE: DATA 
TYPE MENU. 

Option 2 (RASTER DATA (512 X 512)) of I-DEAS MENU will process I-DEAS 
raster/shaded data. This option will translate raster data into the device- 
independent raster metafile format with a resolution of 512 x 512. The 
resolution is determined by the I-DEAS device driver used during creation 
of the raster file. Raster files with a resolution larger than 512 x 512 will 
be clipped. This translation of raster data is done by the following 
sequence: 

ENTER THE NAME OF THE FILE CONTAINING THE I DEAS RASTER 
PICTURE DATA: 

(ENTER FULL PATHNAME IF FILE IS NOT IN CURRENT DIRECTORY.) 

This question allows you to select the I-DEAS raster picture file to be 
processed. An entry of carriage return will return you to the I-DEAS 
METAFILE: DATA TYPE MENU. This selection is followed by the FILE TYPE 
MENU: 

I DEAS METAFILE: FILE TYPE MENU 

1 . BINARY FORMAT [DEFAULT] 

2. FORMATTED 

You must enter the option number of the format of your data file that is 
to be processed. This format was selected within I-DEAS when picture 
output was activated. An entry of carriage return will result in the 
default selection of binary format. 

The next question regards the raster metafile name. 

ENTER THE NAME OF THE FILE TO CONTAIN RASTER OUTPUT DATA: 
(ENTER FULL PATHNAME IF FILE IS NOT TO BE LOCATED IN CURRENT 
DIRECTORY.) 

This allows the user to select the name of the output file. The next 
question relates to the SDRC header information placed by default on all 
graphics output within I-DEAS. 
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DO YOU WISH TO HAVE THE SDRC HEADER INFORMATION 
INCLUDED IN YOUR PICTURE? 

ENTER SELECTION: H, Y OR [N] 

Selecting N (default) will remove the SDRC header from the final output. 
SDRC header selection is followed by the BACKGROUND COLOR MENU. 

I DEAS METAFILE: BACKGROUND COLOR MENU 

1. BLACK 

2. WHITE 

3. USER DEFINED 

4 . BACKGROUND COLOR FROM I-DEAS FILE [DEFAULT] 

This menu allows you to choose the color of the background regardless of 
what the background color was defined when the picture was created in 
I-DEAS. Selection of option 3 will require red, green, and blue intensity 
values from 0 to 255 to be entered. 


ENTER RED COMPONENT (VALUE 0 - 255): 

ENTER GREEN COMPONENT (VALUE 0 - 255): 

ENTER BLUE COMPONENT (VALUE 0 - 255): 

After processing, which may take 5 to 30 minutes, you will be asked if 
you wish to process another raster data file. 

PROCESS ANOTHER I DEAS RASTER FILE ? 

ENTER SELECTION: H, Y OR [NJ 

Entering N (default) will return you to the I-DEAS METAFILE: DATA TYPE 
MENU. 
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Option 3 (RASTER DATA (1024 X 1024)) of the I-DEAS MENU will process 
I-DEAS raster/shaded data. This option will translate raster data into a 
device-independent raster metafile format with a resolution of 1024 x 

1024. Raster files with resolutions larger than 1024 x 1024 will be 

clipped. Raster files with a resolution less than 1024 x 1024 will be 
centered within the 1024 x 1024 resolution. The process for this option 
follows the same sequence as option 2 (RASTER DATA (512 X 512)) and 
should be referenced in regards to this option. 

Option 4 (RASTER DATA (2048 x 2048)) of the I-DEAS MENU will process 
I-DEAS raster/shaded data. This option will translate raster data into a 
device-independent raster metafile format with a resolution of 2048 x 

2048. Raster files with resolutions larger than 2048 x 2048 will be 

clipped. Raster files with a resolution less than 2048 x 2048 will be 
centered within the 2048 x 2048 resolution. The process for this option 
follows the same sequence as option 2 (RASTER DATA (512 X 512)) and 
should be referenced in regards to this option. 

Option 5 (EXIT TO PREVIOUS MENU) of I-DEAS MENU returns you to the 
GENERATE METAFILE: TRANSLATOR MENU. 

GENERATE METAFILE MENU OPTION 2: MSC/NASTRAN 

Option 2 (MSC/NASTRAN) of GENERATE METAFILE will process 
MSC/NASTRAN plot files. This option handles the translation of a plot file 
into a DI-3000 vector metafile. You will be asked to enter the name of 
the file containing the MSC/NASTRAN plot data. 

ENTER THE NAME OF THE FILE CONTAINING THE MSC/NASTRAN PLOT 
DATA: 

(ENTER FULL PATHNAME IF FILE IS NOT IN CURRENT DIRECTORY.) 

After the plot file name is entered, the data is immediately processed. 

The frame number and the number of data points within the current 
frame will be displayed. When processing is completed, the following 
question will be displayed. 

ENTER VAX METAFILE NAME: 
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This allows you to enter the name of the metafile. The final question 
regards processing another plot file. 


PROCESS ANOTHER MSC/NASTRAN PLOT FILE ? 

ENTER SELECTION: H, Y OR [N] 

Entering N (default) will return you to the GENERATE METAFILE MENU. 


TRANSLATOR MENU OPTION 3: MATRIXX 

Option 3 (MATRIXX) of GENERATE METAFILE MENU will process MATRIXx 
laser output files. The MATRIXx file must be output by a laser type 
device driver (ex. LN03). Typically the default output name of the 
MATRIXx laser device driver is MATLASER.DAT. Once the MATRIXx data 
is of the laser output format then this option may be utilized to translate 
the output into a device-independent DI-3000 metafile. You will be 

prompted for the name of the file containing the MATRIXx laser picture 
data. 

ENTER THE NAME OF THE FILE CONTAINING THE MATRIXX LASER 
PICTURE DATA: 

(ENTER FULL PATHNAME IF FILE IS NOT IN CURRENT DIRECTORY.) 

After entering the MATRIXx file name, the main MATRIXX PROCESSOR 
MENU will be displayed. 

MATRIXX METAFILE: FILE ACTION MENU 

1 . LIST FRAME NUMBERS 

2. PROCESS FILE 

3 . ENTER A NEW FILE NAME 

4 . EXIT TO PREVIOUS MENU [DEFAULT] 

Option 1 (LIST FRAME NUMBERS) will list the number of frames in the 
selected data file. 
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Option 2 (PROCESS FILE) processes the laser data file. To process the 
data, a series of questions will be asked about the output attributes to be 
used during processing. The first attribute is the orientation of the data. 

MATRIXX METAFILE: PLOT ORIENTATION MENU 

1 . PORTRAIT [DEFAULT] 

2. LANDSCAPE 

Portrait orientation will cause the data to be processed in a window 
dimensioned 8.5 inches wide by 11 inches high. Landscape results in a 
window of 1 1 inches wide by 8.5 inches high. 

The number of frames to be processed is entered next. 


ENTER FRAME NUMBER TO BE PROCESSED: 

ENTER START FRAME NUMBER OR <CR> FOR DEFAULT: 


Entering carriage return (<CR>) results in the processing of all frames on 
the data file. Entering a number will result in the starting frame number 
and will be followed with the question: 


ENTER END FRAME NUMBER OR <CR> FOR DEFAULT: 


Entering <CR> causes all remaining frames to be processed. Entering a 
number will result in all frames through the ending frame number to be 
processed. The scale factor attribute menu is displayed next. 


ENTER SCALE FACTORS: 

ENTER X-SCALE FACTOR OR <CR> FOR DEFAULT: 
ENTER Y-SCALE FACTOR OR <CR> FOR DEFAULT: 
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Entering a <CR> results in the default of no scaling of data. Entering a real 
number scale factor will result in data being scaled. X and Y scale factors 
should be kept proportional to original X,Y ratio. This is the responsibility 
of the user. Next you will be prompted for the number of the character 
font you would like. 

ENTER FONT NUMBER OR <CR> FOR DEFAULT: 

The entering of a font number will choose a specific DI-3000 character 
font. Font choice is only possible when the DI-3000 library is loaded with 
the processor, otherwise hardware characters are used for text. By 
default, font capability is not available. If font capability is needed, see 
your System Administrator. The final choice is a color option: 

MATRIXX METAFILE : COLOR PROCESSING MENU 

1 . B/W [DEFAULT] 

2. COLOR 


Option 1 (B/W) will process data in black and white. 

Option 2 (COLOR) provides a crude method of adding color to MATRIXx 
plots. This option will inform the user of all pen changes, font calls 
(indicating text output), symbol changes and new frames. At each point 
the user will be allowed to choose a color. The user must be warned that 
there is no distinction within the data file of axis, tick marks, data curves, 
etc., and color consistency will have to come through trial and error in 
adding color at the pen changes. After the data has been processed you 
will be asked: 

ENTER VAX METAFILE NAME: 

After entering a metafile name you will be asked: 

PROCESS ANOTHER MATRIXX LASER RLE ? 

ENTER SELECTION: H, Y OR [N] 
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Selecting N (default) will return you to the GENERATE METAFILE : 
TRANSLATOR MENU. Option Y will return you to the beginning of the 
MATRIXX Processor. 

Option 3 (ENTER A NEW FILE NAME) will allow the user to enter a new 
laser data file name for processing. 

Entering Q (QUIT) of GENERATE METAFILE MENU will return you to the 
IMAT EXECUTIVE: GRAPHICS MENU. 
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PROCESSOR: DISPLAY METAFILE 

PURPOSE: The DISPLAY METAFILE processor provides the IMAT 

user with the ability to display DI-3000 metafiles and Raster 
Metafile format files on interactive display devices. 

When the DISPLAY METAFILE processor is invoked, the following 
menu will be displayed: 

DISPLAY METAFILE: METAFILE TYPE MENU 

1. VECTOR 

2. RASTER 

METAFILE TYPE MENU OPTION 1: VECTOR 

Option 1 (VECTOR) will let you interactively display DI-3000 
metafiles. By using this path you will be presented with the 
following sequence of menus: 

DISPLAY METAFILE: DEVICE SELECTION MENU 

1. VT 240 

2. TEK 4105 

3. TEK 4107/4109 

4. TEK 4114 

5. TEK 4115 

6. POSTSCRIPT 

7 . EXIT TO PREVIOUS MENU [DEFAULT] 

Select the device type which you are using. The device list should 
reflect the device drivers available on your machine. You will then 
be presented with a list of DI-3000 commands. It might be helpful 
to have your printer turned on for this display or make a hard copy 
of the display as you will need to know these commands during the 
plotting session. The display is presented here for your convenience: 
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«< YOU WILL NEED THE FOLLOWING COMMANDS TO >» 

«< RESPOND TO THE DI-3000 PROMPTS TO FOLLOW »> 

THE FOLLOWING IS A SAMPLE OF TRANSLATOR COMMANDS 


S MF # FILE NAME 
D P# MF# 

D P FROM FIRST TO LAST 
S W # (L R B T) 

S V # (L R B T) 

QUIT 

S DEV # ON/OFF 


<- SETS METAFILE TO FILE 
NAMED 

<- DRAW PICTURE 
<- DRAWS ALL PICTURES 
<- SET WINDOW 
<- SET VIEWPORT 
<- EXIT TRANSLATOR 
<- SET DEVICE ON/OFF 


«< WAIT FOR M> PROMPT TO RESPOND »> 


NOTE: # should be replaced with a number. 


At this point, your terminal will be placed in graphics mode and you 
may use the above commands to respond to prompts. See the 
METAFILE SYSTEM USER'S GUIDE for a complete description of 
metafile commands. 

METAFILE TYPE MENU OPTION 2: RASTER 

Option 2 (RASTER) will let you interactively display Raster Metafiles. 
By using this path you will be presented with the following menus: 


DISPLAY METAFILE: DEVICE SELECTION MENU 

1 . CONVERT INTENSITY TO COLOR TABLE 

2. TEK 4107/4109 

3. TEK 4125 

4. AED767 

5. DIOOMED 

6. VERSATEC 
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7. POSTSCRIPT 

8. DUMMY DRIVER 

9. EXIT TO PREVIOUS MENU [DEFAULT] 


Option 1 (CONVERT INTENSITY TO COLOR TABLE) will convert the 
intensity raster file, which is produced in GENERATE METAFILE 
I-DEAS processor, into a color table raster file. Once in color table 
format, the file may be interactively displayed on a raster terminal. 


NOTE: Option 1 must be selected and executed prior to any 

interactive display. 

Select the device type you are using (options 2 through 8). You will 
then be presented with a short list of Raster Metafile Translator 
commands. Appendix C contains a complete list of Raster Metafile 
Translator commands. Entering HELP while in the Raster Metafile 
Translator will activate an on-line help facility. 


«< YOU WILL NEED THE FOLLOWING COMMANDS TO RESPOND TO »> 
«< THE RASTER METAFILE TRANSLATOR PROMPTS TO FOLLOW »> 


THE FOLLOWING IS A SAMPLE OF TRANSLATOR COMMANDS 


SET MF # FILE NAME 

D P # MF # 

QUIT 

SET WINDOW # (XMIN XMAX YMIN YMAX) 
SET VIEWPORT # (XMIN XMAX YMIN YMAX) 
CONVERT MF # MF # 


<- SET METAFILE TO 
FILE NAMED 
<- DRAW PICTURE 
<- EXIT TRANSLATOR 
<- SET WINDOW 
<- SET VIEWPORT 
<- CONVERTS 

METAFILE FORMAT 


«< WAIT FOR RMT> PROMPT TO RESPOND »> 


GRAPHICS 


4-13 


DISPLAY METAFILE 4 


At this point, your terminal will be placed in graphics mode and you 
may use the above commands to respond to prompts. When QUIT is 
entered, you will return to the IMAT EXECUTIVE. 
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PROCESSOR: GENERATE PICSURE COMMAND FILE 

PURPOSE: The GENERATE PICSURE COMMAND FILE processor 

provides the IMAT user with the ability to create PicSure command 
files, which will generate X,Y plots from data files. The data files can 
be from MATRIXx (vector, matrix, or Bode formats), MSC/NASTRAN 
(PUNCH file format), or free format data. 

When the GENERATE PICSURE COMMAND FILE processor is invoked, 
the following menu will be displayed: 

GENERATE PICSURE COMMAND FILE: PLOT TYPE MENU 

1 . MATRIXX VECTOR/MATRIX PLOTS 

2. MATRIXX BODE PLOTS 

3. NON-MATRIXX DATA 

PLOT TYPE MENU OPTION 1: MATRIXX VECTOR/MATRIX 
PLOTS 

Option 1 (MATRIXX VECTOR/MATRIX PLOTS) will allow you to 
generate PicSure command files which will create X, Y plots from 
MATRIXX formatted data. The following sequence of menus will be 
displayed for this option. 


ENTER THE NAME OF THE FILE CONTAINING THE MATRIXX DATA: 
(ENTER FULL PATHNAME IF FILE IS NOT IN CURRENT DIRECTORY ) 

Enter the name of the file which contains the MATRIXx formatted 
data. This will be followed by: 


ENTER A NAME FOR YOUR PICSURE COMMAND FILE [PIC.CMD]: 


Enter the name of a file which will contain the PicSure commands. 
Entering carriage return will result in the default file name of 
PIC.CMD. This question will be followed by a list of the data 
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components found in the named data file. You will then be 
requested to select one independent dataset from the list and up to 
seven dependent datasets. The format of the dataset list is as 
follows: 


GENERATE PICSURE COMMAND FILE: DATA SET MENU 
DATA VARIABLES FOUND IN MATRIXX FILE: [FILE NAME] 



VARIABLE 

ROWS 

COLUMNS 

1 

VARIABLE 1 

# 

# 

2 

VARIABLE 2 

# 

# 

N 

VARIABLE N 

# 

# 


NOTE: DATASETS CHOSEN MUST BE VECTORS WITH 

DIMENSIONS THAT MATCH. 


SELECT ONE INDEPENDENT VARIABLE: 

SELECT DEPENDENT VARIABLE # 1 : 

SELECT DEPENDENT VARIABLE # 2 [NONE]: 

NOTE: Datasets chosen must have the same dimensions. 

Enter the number of the dataset you wish to select for each question. 
Enter a carriage return when you have completed your selections. At 
least one independent and one dependent dataset must be chosen to 
output a plot. If the variable chosen is of matrix format, (i.e., 
C0LUMNS>1) then you will be asked to select which columns are to 
be used as dependent variables: 
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NOTE: VARIABLE CHOSEN IS OF MATRIX FORMAT 
PLEASE SELECT BY COLUMN. 

MATRIX HAS COLUMNS 1 - N: 

SELECT COLUMN #1 [NONE]: 

SELECT COLUMN #2 [NONE]: 


Select the column(s) desired and enter carriage return when done. 
You will then be prompted to enter text for your graph through the 
following sequence of questions: 


ENTER A TITLE FOR THIS GRAPH: 

ENTER A SUBTITLE FOR THIS GRAPH [NONE]: 
ENTER A LABEL FOR THE X-AXIS: 

ENTER A LABEL FOR THE Y-AXIS: 


Enter a text string for each question. A carriage return for the 
subtitle will result in no subtitle for the graph. All questions must be 
answered with a text string. When this sequence has been 
completed the following message is displayed listing files that have 
been or will be created. Please read the note carefully. 


THIS PROCESSOR CREATES THE FOLLOWING FILES: 
COMMAND FILE => [FILE NAME] 

DATA FILES =i> DATASET NAME FROM DATA FILE 

WITH ONE OF THE FOLLOWING 
ENDINGS: _I.DAT, _D.DAT, _D#.DAT 

AFTER RUNNING THE COMMAND FILE WITHIN PICSURE 
THE FOLLOWING FILES WILL EXIST: 

METAFILE => [FILE NAME], MFL 
CHART FILE => [FILE NAME], CHT 
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BE SURE TO DELETE THESE FILES WHEN NO LONGER NEEDED. 

YOUR PICSURE COMMAND FILE FOR THIS PLOT IS: [FILE NAME] 
THIS COMMAND FILE SHOULD BE EXECUTED WITHIN PICSURE 
WITH THE COMMAND: 

READ COMMAND [FILE NAME] 

BE SURE TO DELETE THIS COMMAND FILE AND ALL PREVIOUSLY 
MENTIONED FILES WHEN YOU HAVE COMPLETED PROCESSING. 


This command file will display the plot interactively and will 
generate a chart file and a vector metafile. 

PLOT TYPE MENU OPTION 2: MATRIXX BODE PLOTS 

Option 2 (MATRIXX BODE PLOTS) will allow you to create a Bode plot 
from phase-magnitude data. The command file for this format is 
generated through the following sequence of commands: 


ENTER THE NAME OF THE FILE CONTAINING THE MATRIXX DATA: 
(ENTER FULL PATHNAME IF FILE IS NOT IN CURRENT DIRECTORY.) 


Enter the name of the file containing the Bode plot data. Then you 
will be prompted for the name of a file to contain the PicSure 
commands. 


ENTER A NAME FOR YOUR PICSURE COMMAND FILE [PIC.CMD]: 


Entering a carriage return will result in the command file being 
named PIC.CMD. Following this question will be a list of the data 
elements found on the named file. The format of the data list is as 
follows: 
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GENERATE PICSURE COMMAND FILE: DATA SET MENU 
DATA VARIABLES FOUND IN MATRIXX FILE: [FILE NAME] 



VARIABLE 

ROWS 

COLUMNS 

1 

VARIABLE 1 

# 

# 

2 

VARIABLE 2 

# 

# 

N 

VARIABLE N 

# 

# 


NOTE: DATASETS CHOSEN MUST BE VECTORS WITH 

DIMENSIONS THAT MATCH. 


SELECT ONE INDEPENDENT VARIABLE: 

SELECT DEPENDENT VARIABLE # 1: 

SELECT DEPENDENT VARIABLE # 2 [NONE]: 

Enter the number of the dataset you wish to select for each question. 
Enter a carriage return when you have completed your selections. At 
least one independent and one dependent dataset must be chosen to 
output a plot. A maximum of two dependent datasets may be chosen 
for the Bode plot format. If the variable chosen is of matrix format, 
(i.e., C0LUMNS>1) then you will be asked to select which column(s) 
are to be used as dependent variables by the following question: 


NOTE: VARIABLE CHOSEN IS OF MATRIX FORMAT, 
PLEASE SELECT BY COLUMN. 

MATRIX HAS COLUMNS 1 - N : 

SELECT COLUMN #1: 

SELECT COLUMN #2 [NONE]: 
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Select column(s) and enter carriage return when done. You will then 
be prompted to enter text for your graph through the following 
sequence of questions: 

ENTER A TITLE FOR THIS GRAPH: 

ENTER A SUBTITLE FOR THIS GRAPH [NONE]: 

ENTER A LABEL FOR THE X-AXIS: 

ENTER A LABEL FOR THE Y-AXIS: 


Enter a text string for each question. A carriage return for the 
subtitle will result in no subtitle for the graph. All questions must be 
answered with a text string. When two dependent datasets have 
been chosen you will be questioned for two y-axis labels: 


ENTER A LABEL FOR THE FIRST DEPENDENT 
DATASET CHOSEN FOR THE Y-AXIS: 

ENTER A LABEL FOR THE SECOND DEPENDENT 
DATASET CHOSEN FOR THE Y-AXIS: 


When this sequence has been completed one of the following 
messages will be displayed. Please read the note carefully. For a 
single Bode plot, phase or magnitude only, the following message will 
be displayed: 

THIS PROCESSOR CREATES THE FOLLOWING FILES: 

COMMAND FILE => [FILE NAME] 

DATA FILES => DATASET NAME FROM DATA FILE 

WITH ONE OF THE FOLLOWING 
ENDINGS: _I.DAT, _D.DAT 
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AFTER RUNNING THE COMMAND FILE WITHIN PICSURE 
THE FOLLOWING FILES WILL EXIST: 

METAFILE => [FILE NAME]. MFL 

TITLE CHART FILE => [FILE NAME]_TITLE.CHT 
CHART FILE => [FILE NAME]_TOP.CHT 

BE SURE TO DELETE THESE FILES WHEN NO LONGER NEEDED. 

YOUR PICSURE COMMAND FILE FOR THIS PLOT IS: [FILE NAME] 
THIS COMMAND FILE SHOULD BE EXECUTED WITHIN PICSURE 
WITH THE COMMAND: 

READ COMMAND [FILE NAME] 

BE SURE TO DELETE THIS COMMAND FILE AND ALL PREVIOUSLY 
MENTIONED FILES WHEN YOU HAVE COMPLETED PROCESSING. 


For a composite Bode plot, one in which both phase and magnitude 
are selected, the following message will be displayed: 


THIS PROCESSOR CREATES THE FOLLOWING FILES: 
COMMAND FILE => [FILE NAME] 

DATAFILES => DATASET NAME FROM DATA FILE 

WITH ONE OF THE FOLLOWING 
ENDINGS: _I.DAT, _D.DAT 

AFTER RUNNING THE COMMAND FILE WITHIN PICSURE 
THE FOLLOWING FILES WILL EXIST: 

METAFILE => [FILE NAME] .MFL 

TITLE CHART FILE => [FILE NAME]_TITLE.CHT 

TOP CHART FILE => [FILE NAME]_TOP.CHT 

BOTTOM CHART RLE => [RLE NAME]_BOT.CHT 

BE SURE TO DELETE THESE FILES WHEN NO LONGER NEEDED. 
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YOUR PICSURE COMMAND FILE FOR THIS PLOT IS: 

[FILE NAME] 

THIS COMMAND FILE SHOULD BE EXECUTED WITHIN PICSURE 
WITH THE COMMAND: 

READ COMMAND [FILE NAME] 

BE SURE TO DELETE THIS COMMAND FILE AND ALL PREVIOUSLY 
MENTIONED FILES WHEN YOU HAVE COMPLETED PROCESSING. 


The command file created will display the plot interactively and will 
generate a chart file and a vector metafile. 

PLOT TYPE MENU OPTION 3: NON-MATRIXX DATA 

Option 3 (NON-MATRIXX DATA) will allow you to process non- 
MATRIXx type data into an X,Y plot. The non-MATRIXx type data 
includes MSC/NASTRAN PUNCH file and free format data. First you 
must pick the type of data from the following menu: 

NON-MATRIXX DATA: DATA FORMAT MENU 

1 . MSC/NASTRAN PUNCH DATA FORMAT 

2 . FREE FORMATTED DATA 


Option 1 (NASTRAN PUNCH DATA FORMAT) will allow you to process 
MSC/NASTRAN data which was output to a PUNCH file using the 
XYPUNCH command. The command file for this format is generated 
through the following sequence of commands: 


ENTER THE NAME OF THE FILE CONTAINING THE MSC/NASTRAN 
DATA 

(ENTER FULL PATHNAME IF FILE IS NOT IN CURRENT DIRECTORY.) 
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Enter the name of the PUNCH file. You will then be prompted for the 
name of a file to contain PicSure commands. 


ENTER A NAME FOR YOUR PICSURE COMMAND FILE [PIC.CMD]: 


Entering a carriage return will result in the command file being 
named PIC.CMD. At this time the file is read to extract the data 
variables found in the file. There is a maximum of twenty allowable 
variables. If this limit is exceeded you will receive the following 
prompt: 

EXCEEDED VARIABLE LIMIT, ONLY THE FIRST 20 VARIABLES 

ARE ACCESSIBLE. 

ENTER <CR> TO CONTINUE 


Enter carriage return to continue. The data variables retrieved will 
be listed in the following format: 


GENERATE PICSURE COMMAND FILE: DATA SET MENU 
DATA VARIABLES FOUND IN PUNCH FILE: [FILE NAME] 


1 

2 

3 

4 

5 


N 


DATA VARIABLES 

NODE 

DATA 

$LOAD 

65 

3 

$LOAD 

102 

3 

$ACCE 

1 1008 

3 

$ACCE 

1 1008 

4 

$ACCE 

11008 

5 

$ACCE 

###### 

# 
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You will then be prompted to enter the number of the variable you 
wish to have plotted: 


SELECT VARIABLE: 


You will then be asked to enter an increment value to be used in case 
of a large dataset which may exceed PicSure's data point limit of 
10,000 data points. The increment will be used to select every Nth 
data value from the file. 


ENTER INCREMENT TO BE USED WITH DATA VALUES: 
ENTER VALUE 1-10 OR<CR> 


Entering carriage return will result in all values being plotted. You 
will then be prompted to enter text for your graph through the 
following sequence of questions. 


ENTER A TITLE FOR THIS GRAPH: 

ENTER A SUBTITLE FOR THIS GRAPH [NONE]: 
ENTER A LABEL FOR THE X-AXIS: 

ENTER A LABEL FOR THE Y-AXIS: 


Enter a text string for each question. A carriage return for the 
subtitle will result in no subtitle for the graph. All questions must be 
answered with a text string. When this sequence has been 
completed the following message is displayed listing the files which 
have been created or will be created. Please read the note carefully. 
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THIS PROCESSOR CREATES THE FOLLOWING FILES: 

COMMAND FILE => [FILENAME] 

DATA FILES => DATASET NAME FROM DATA FILE 

WITH ONE OF THE FOLLOWING 
ENDINGS: _X.DAT, _Y.DAT 

AFTER RUNNING THE COMMAND FILE WITHIN PICSURE 
THE FOLLOWING FILES WILL EXIST: 

METAFILE => [FILE NAMEJ.MFL 

CHART FILE => [FILE NAMEJ.CHT 

BE SURE TO DELETE THESE FILES WHEN NO LONGER NEEDED. 

YOUR PICSURE COMMAND RLE FOR THIS PLOT IS: [RLE NAME] 
THIS COMMAND FILE SHOULD BE EXECUTED WITHIN PICSURE 
WITH THE COMMAND: 

READ COMMAND [FILE NAME] 

BE SURE TO DELETE THIS COMMAND FILE AND ALL PREVIOUSLY 
MENTIONED FILES WHEN YOU HAVE COMPLETED PROCESSING. 

ENTER <CR> TO CONTINUE 


This command file will display the plot interactively and will 
generate a chart file and a vector metafile. 


Option 2 (FREE FORMATTED DATA) will allow you to process what 
PicSure considers free format data. This is any file which contains 
data points separated by commas, blank(s), or text. This is limited to 
a single dataset per file. The command file for this format is 
generated through the following sequence of commands: 


ENTER A TITLE FOR THIS GRAPH: 

ENTER A SUBTITLE FOR THIS GRAPH [NONE]: 
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ENTER A LABEL FOR THE X-AXIS: 
ENTER A LABEL FOR THE Y-AXIS: 


Enter a text string for each question. A carriage return for subtitle 
results in no subtitle for the graph. All questions must be answered 
with a text string (except for subtitle). No defaults are available. 
When this sequence has been completed, you will be prompted to 
enter a file name to contain the PicSure commands: 


ENTER A NAME FOR YOUR PICSURE COMMAND FILE [PIC.CMD]: 


Entering a carriage return will result in the file being named 
PIC.CMD. You will then be prompted to enter the name of the file 
containing the independent dataset. This will be followed by the 
prompt to enter the name to be given to the dataset within PicSure: 

ENTER INDEPENDENT FILE NAME: 

ENTER INDEPENDENT DATASET NAME: 


At the next prompt, enter the name of the file containing the 
dependent dataset. This will be followed by the name to be given to 
the dataset within PicSure. 


ENTER DEPENDENT FILE NAME: 
ENTER DEPENDENT DATASET NAME: 


These two questions will be repeated until a carriage return is 
entered for the dependent file name or seven dependent file names 
have been given. At this point the following message is displayed. 
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listing the files that have been created or will be created. Please 
read the note carefully. 


THIS PROCESSOR CREATES THE FOLLOWING FILES: 

COMMAND FILE => [FILE NAME] 

AFTER RUNNING THE COMMAND FILE WITHIN PICSURE 
THE FOLLOWING FILES WILL EXIST: 

METAFILE => [FILE NAMEJ.MFL 

CHART FILE => [FILE NAMEJ.CHT 

BE SURE TO DELETE THESE FILES WHEN NO LONGER NEEDED. 

YOUR PICSURE COMMAND FILE FOR THIS PLOT IS: [FILE NAME] 
THIS COMMAND FILE SHOULD BE EXECUTED WITHIN PICSURE 
WITH THE COMMAND: 

READ COMMAND [FILE NAME] 

BE SURE TO DELETE THIS COMMAND FILE AND ALL PREVIOUSLY 
MENTIONED FILES WHEN YOU HAVE COMPLETED PROCESSING 
OF THE COMMAND FILE. 

ENTER <CR> TO CONTINUE 

This command file will display the plot interactively and will 
generate a chart file and a vector metafile. 

Entering Q (QUIT) will return you to the IMAT EXECUTIVE: 
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PROCESSOR: EXECUTE PICSURE 

PURPOSE EXECUTE PICSURE allows the user to use Precision 
Visuals’ PicSure to generate charts and graphs interactively. 

ENTERING YOUR GRAPHICS DEVICE: 

At the beginning of execution, PicSure will display a menu of the 
available graphics devices and then prompt you to enter your 
graphics device type. 

ENTER THE CODE FOR YOUR GRAPHICS TERMINAL: 

Enter the code for the the graphics terminal or terminal emulation 
you are using. The following devices are examples of devices which 
may be supported and their PicSure code. 


CODE 

TERMINAL 

405 

TEK 4105 

407 

TEK 4107/4109 

415 

TEK 4115/4125 

240 

VT240 

T14 

TEK 4014 

PST 

POSTSCRIPT 

750 

HP 7550A 


ON-LINE HELP: 

Text charts, and line, bar, and pie charts may be created in PicSure 
using English-like commands. If you have never used PicSure, enter 
the command HELP TUTORIALS for an on-line tutorial session. For 
information on a specific command, type HELP or HELP XXXXXXXX 
where XXXXXXXX is the command for which you want an explanation. 
For more information on PicSure, see the PicSure USER’S GUIDE. 

RETURNING TO THE IMAT EXECUTIVE: 

Enter QUIT to exit from PicSure and return to the IMAT EXECUTIVE. 
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PROCESSOR: HARDCOPY METAFILE (for use at LaRC only) 


PURPOSE. The HARDCOPY METAFILE processor provides the IMAT 
iiser with the ability to generate hardcopy output of DI-3000 
metafiles and Raster Metafile format files on ACD Production devices. 


When the HARDCOPY METAFILE 
menu will be displayed: 


processor is invoked, the following 


HARDCOPY METAFILE: METAFILE TYPE MENU 


1. VECTOR 

2. RASTER 

3. EXIT TO PREVIOUS MENU (DEFAULT] 

METAFILE TYPE MENU OPTION 1: VECTOR 


Option 1 (VECTOR) will let you output DI-3000 metafiles. By u*.i,w 
this path you will be presented with the following sequence of 
menus First you will be asked to enter the metafile file name, 

ollowed by the entering of a filename to be given to the VAX 
command file. 


fp N MTC R p T £f, 0F THE F,LE CONTAINING THE METAFILE: 
(ENTER FULL PATHNAME IF FILE IS NOT IN CURRENT 
DIRECTORY.) E1 1 


ENTER A NAME FOR THE COMMAND FILE [PLOTJOB.COM]: 

‘' Ca ™f relurn < <CR> ) is entered for the command file, then the 
default file name PLOTJOB.COM will be used. Next will be a series of 
ques tons which relate to CDC/NOS job information. Answer each 
question as it is displayed. 
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ENTER NOS USER NUMBER 

ENTER NOS PASSWORD 

ENTER NOS CHARGE NUMBER 

ENTER NOS MACHINE CODE (A/D/Y/Z) 

ENTER VAX USER NAME 

ENTER VAX PASSWORD 

ENTER NOS DELIVERY DESTINATION 

ENTER YOUR NAME 


You will then be asked to enter a NOS filename, of seven or less 
characters, to be given to the metafile on the NOS machine. 

ENTER NOS METAFILE FILE NAME 

The next menu displays a list of available vector hardcopy devices. 


VECTOR METAFILE: HARDCOPY DEVICE MENU 

1. CALCOMP, 11 INCH 

2. CALCOMP, 34 INCH 

3. VARIAN, ROLL 

4. VARIAN, FANFOLD 

5. COLOR VERSATEC, (VER,39) 

6. CELCO 16MM SLIDES, (CEL,16) 

7. CELCO 8X10 VIEWGRAPHS, (CEL, 8) 

8. NO PLOTTING DESIRED [DEFAULT] 
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Upon selecting a hardcopy device, if appropriate, you will be asked to 
enter plotcard parameters and plot operator instructions. See ACD 
PRODUCTION PLOTTER DEVICE DRIVER GUIDE for further information. 

ENTER ANY PLOT CARD PARAMETERS AT 
THIS TIME, INCLUDE PARENTHESIS. 

EX: (HEIGHTS 1 .,WIDTH=7.,YO=.5,XO=.5,RVAX,PAGE=8) 


ENTER ANY SPECIAL PLOTTING INSTRUCTIONS TO BE 
PLACED IN CONTINUATION LINES. 

MAX OF 20 LINES WITH 40 CHARS PER LINE 
ENTER <CR> WHEN FINISHED. 


You will then be asked to enter a NOS filename to contain dayfile 
information: 

ENTER NOS DAYFILE NAME (UP TO 7 CHARS): 

This will be followed by selection of default metafile processing 

commands, which will process all frames, or enter your own metafile 
commands: 


DO YOU WISH DEFAULT METAFILE COMMANDS 
FOR PROCESSING? [Y]/N 


Upon completion of this final question your job and metafile are 
submitted automatically for processing and the following message 
will be displayed: 


DATA IS ON FILE [FILE NAME] WHICH IS AUTOMATICALLY 
FLINKED TO THE CYBERS FOR PROCESSING. YOUR DAYFILE AND 
METAFILE WILL RESIDE ON THE MACHINE YOU CHOSE UNDER 
YOUR CHOSEN NAME. THE DAYFILE WILL BE FLINKED BACK TO 
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THE VAX AS [DAYFILE NAMEJ.LOG UPON COMPLETION AND CAN 
BE CHECKED BY YOU. BE SURE TO DELETE THIS .LOG FILE WHEN 
YOU ARE DONE. LIKEWISE THE DAYFILE ON NOS SHOULD BE 
DELETED AT YOUR CONVENIENCE. SINCE THE METAFILE RESIDES 
ON NOS, YOUR VAX VERSION CAN BE DELETED. ANY FUTURE NEED 
OF THE METAFILE, SIMPLY USE FLINK TO RETRIEVE THE FILE 
FROM NOS. VAX FILES [FILE NAMEJ.COM AND [FILE NAMEJ.DAT 
SHOULD BE DELETED WHEN PROCESSING IS COMPLETED. 


METAFILE TYPE MENU OPTION 2: RASTER 

Option 2 (RASTER) will let you generate hardcopy output of Raster 
Metafile format files. By using this path you will be presented with 
the following sequence of menus. First, you will be asked to enter 
the metafile file name, followed by a file name to be given to the 
command file. 


ENTER THE NAME OF THE FILE CONTAINING THE METAFILE: 
(ENTER FULL PATHNAME IF FILE IS NOT IN CURRENT DIRECTORY.) 


ENTER A NAME FOR THE COMMAND FILE [PLOTJOB.COM]: 


If carriage return (<CR>) is entered for the command file, then the 
default file name PLOTJOB.COM will be used. Next will be a series of 
questions which relate to CDC/NOS job information. Answer each 
question as it is displayed. 


ENTER NOS USER NUMBER 
ENTER NOS PASSWORD 
ENTER NOS CHARGE NUMBER 
ENTER NOS MACHINE CODE (A/D/Y/Z) 
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ENTER VAX USER NAME 
ENTER VAX PASSWORD 
ENTER NOS DELIVERY DESTINATION 
ENTER YOUR NAME 


The next menu lists available raster hardcopy devices. 


RASTER METAFILE: DEVICE DRIVER LIST 

1. CELCO 

2. VERSATEC 

3. EXIT TO PREVIOUS MENU [DEFAULT] 

Select a device. Selecting option 1 (CELCO) will result in the following 
additional menu. Select the type of output desired. 

CELCO OUTPUT: OUTPUT TYPE 

1. 8 X 10 (VIEWGRAPH) 

2. 16MM (MOVIE) 

3. 35MM (SLIDES) 

4. EXIT TO PREVIOUS MENU [DEFAULT] 

Option 2 (VERSATEC) can be selected only after the Raster Metafile 
format file has been converted to Versatec format. This converstion 
is accomplished by running the Raster Metafile Translator Versatec 
device driver found in the DISPLAY METAFILES processor. 

After selecting the output device, you will then be asked to enter a 
NOS filename, of seven of less characters, to be given to the metafile 
on the NOS machine. 


ENTER NOS METAFILE FILE NAME 
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The next question is a request for you to enter a NOS filename for 
dayfile information. 

ENTER NOS DAYFILE NAME (UP TO 7 CHARACTERS): 

Upon completion of this final question, your job and metafile are 
submitted for processing. 

METAFILE TYPE MENU OPTION 3: EXIT 

Option 3 (EXIT) will return you to the IMAT EXECUTIVE: GRAPHICS 
MENU. 
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Finite element models are usually created by an IMAT user with the 
aid of SDRC's preprocessor code SUPERTAB. The finished model data 
is then loaded into tables called relations in an IMAT-defined RIM 
database and an MSC/NASTRAN data deck is generated for 
performing a Solution 3 Normal Modes analysis. Both SUPERTAB and 
MSC/NASTRAN are general-purpose codes that support a variety of 
finite element types, analysis types, and analysis data types. The 
IMAT database and the IMAT processor codes, which were 
specifically developed to solve dynamics and control problems of 
large space-based structures, do not support all of the features of the 
commercial application codes. The following sections describe the 
finite element features that are supported and the correspondence of 
data stored in the database to data used in the application codes. 

Coordinate Systems 

Multiple coordinate systems are not supported in IMAT. All data 
containing coordinate locations refer to a single global XYZ coordinate 
system. In MSC/NASTRAN, this system is referred to as the basic 
coordinate system. 

Finite Elements 

Table 1 lists the finite elements currently supported by IMAT and 
the corresponding SUPERTAB and MSC/NASTRAN elements. 
MSC/NASTRAN physical property cards are shown in parentheses. 

Two-dimensional triangular elements are stored in relation 
TRIANGLS and quadrilateral elements are stored in relation QUADS. 
Both relations contain connectivity descriptions, thickness, and non- 
structural mass per unit area. Therefore there is no separate 
physical property relation for these elements. 

Lumped mass elements are stored in relation CONMASS. Attributes 
describing the lumped masses include the element number, node 
number, mass, and mass moments of inertia. Note that the mass 
moments of inertia (Mass Inertia Matrix) must be carefully specified 
in the correct order in SUPERTAB. The center of mass of a lumped 
mass element may be offset from the grid point (node) location 
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by specifying x, y and z offsets. Remember, IMAT does not support 
muluple coordinate systems, so the xyz offsets must refer to the 

^iiPCD^m coordinate SyStem ( coordinat e system number 0 in 
oUrbKI AB). Table 2 shows the attributes stored in CONMASS and the 
corresponding parameters in SUPERTAB and MSC/NASTRAN 


Data handling for beam elements is much more complicated than for 
any other type of supported element. IMAT supports two types of 
two-node elastic elements - rod elements, which have only axial and 
torsional stiffness, and linear prismatic beam elements, which have 
axial, torsional, shear and bending stiffness. (Rod element data is 
stored in the same relations as beam data. However, rod elements 
are not discussed in detail here.) 


If i* T s , chema con,ains three relations for storing beam 

aata Ihe BEAMS relation contains connectivity data such as node 

numbers, end releases, and shear center offsets, that are arranged in 
columns called attributes. Each row of information in the BEAMS 

Lt “' n “" s ' he , values »f attributes for one beam element. 
The BEAMPROP relation contains physical property attributes such as 
cross-sectional areas and moments of inertia. Each row of the 
BEAMPROP relation contains the attributes that describe one physical 
property entry. The BEAMREF relation contains beam orientation 
ata in the form of either reference nodes or incremental vectors 
Any number of beams may refer to a single entry (row) in the 
BEAMPROP or BEAMREF relations. Appendix A contains a complete 
listing of all attributes and relations. Note that the BEAMPROP 

i on ‘ ai " s some ^tributes that are not currently used in 
IMAT. Table 3 shows the connectivity, orientation and physical 
property attributes stored in the database, and their corresponding 
parameters in SUPERTAB and MSC/NASTRAN. 8 


Material Properties 


All material property data is stored in relation MAT-PROP, which 
contains attributes describing linear, elastic, homogeneous,’ isotropic 
mat ® ] r, . al ^A' T PR0P contains some attributes that are not currently 
used by IMAT. The features that are currently supported are those 
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that are compatible with MSC/NASTRAN’s MAT1 material property 
card. Note that Poisson's ratio is not stored in MAT-PROP; however, 
any two of the three parameters E (modulus of elasticity), G 
(modulus of rigidity) and NU (Poisson's ratio) may be specified in 
SUPERTAB. The LOAD UNIVERSAL FILE processor will compute E or 
G, if it is not specified, by using the relation G = E/(2(1+NU)). 

Loads and Constraints 

The IMAT database schema contains tables (relations) for storing 
uniform pressures on plate elements (relation ELEMLOAD) and 
concentrated loads at nodes (relation NODELOAD). Dynamic load 
descriptions are not stored. However the RECOVER PHYSICAL 
OUTPUT processor will automatically generate the required 
MSC/NASTRAN dynamic load cards for use in the recovery of 
physical data from a state-space simulation. (See the description of 
the IMAT solution procedure). 

Single point constraints (nodal restraints) are stored in the CONSTRN 
relation. A Y (for restrained) or an N (for unrestrained) is entered 
for each degree of freedom at the restrained nodes. Only one 
restraint case and one load case may be specified for a database. 

Multipoint constraints are supported in the form of "rigid bar 
elements" stored in relation RIGIDBAR. These elements are 
equivalent to MSC/NASTRAN's RBAR "element". A rigid bar element 
consists of two nodes. Each node may have independent and/or 
dependent degrees of freedom associated with it. Note that 
SUPERTAB's "fore end" and "aft end" correspond to "end A" and "end 
B", respectively, in the IMAT-defined database schema, and "GA" and 
"GB" in MSC/NASTRAN. MSC/NASTRAN uses the RBAR descriptions 
to internally generate multipoint constraint equations. 

Analysis Data 

IMAT currently stores only normal modes analysis data in the 
database. Natural frequencies are stored in relation EIGNVALS and 
eigenvectors (mode shapes/slopes) are stored in relation EIGNVECT. 

In addition, a rapid-access binary file containing only eigenvector 
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data is used to facilitate processing of linear system matrices and to 
provide an efficient method of reviewing eigenvector data (see 
QUERY EIGENVECTOR FILE processor). Rigid-body mass properties 
are loaded into relation RIGPROP from a binary MSC/NASTRAN 
OUTPUT2 file that contains the output from the Grid Point Weight 
Generator. Table 4 shows the correspondence between the Grid Point 
Weight Generator output and the data contained in the RIGPROP 
relation. Note that the signs of the off-diagonal inertia matrix terms 
are changed by the LOAD ANALYSIS RESULTS processor to ensure 
that the mass moment of inertia matrix (attribute MASMOMIN) is in 
inertia tensor form. An alter that writes the rigid-body mass 
information to the OUTPUT2 file is automatically generated by the 
FORMAT BULK DATA processor. 

It is the user's responsibility to save certain files after performing a 
Solution 3 Normal Modes analysis with MSC/NASTRAN. A PUNCH file 
containing the checkpoint dictionary and the eigenvectors must be 
saved. The eigenvector (and eigenvalue) data is loaded from this file 
into the database. The Checkpoint Dictionary (contained in the 
PUNCH file) and the New Problem Tape file are required for 
performing restarts for open-loop modal analyses and to recover 
physical data from a closed-loop state-space simulation. The Grid 
Point Weight Generator Output, written to FORTRAN unit 11, must 
also be saved. 
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SUPERTAB 1 

IMAT 

MSC/NASTRAN 2 

ROD 

ROD 

CROD (PROD) 

LINEAR BEAM 

BEAM 

CBAR (PBAR) 

PLN. STRS. LINEAR TRIA. 

TM 

TRIA3 (PSHELL) 

FLAT PLT. LINEAR TRIA. 

TB 

ii 

THIN SHL. LINEAR TRIA. 

TBM 

ft 

PLN. STRS. LINEAR QUAD. 

QM 

QUAD4 (PSHELL) 

FLAT PLT. LINEAR QUAD. 

Q B 

ri 

THIN SHL. LINEAR QUAD. 

QBM 

it 

LUMPED MASS 

CONMASS 

CONM2 

RIGID BAR 

RIGIDBAR 

REAR 


Table 1 Finite elements supported by IMAT 
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SUPERTAB 1 


IMAT 

MSC/NASTRAN 2 

ELEMENT NUMBER 


ELEMENT 

EID 

NODE NUMBER 


NODENUM 

G 

MA_MASS 


MASS 

M 

MIM_MASS INER. MAT.(l) 

11 1 

11 1 

ft 

(2) 

122 

122 

ft 

(3) 

133 

133 

ii 

(4) 

121 

121 

it 

(5) 

131 

131 

it 

(6) 

132 

132 

MO.MASS OFFSETS(l) 


Z1M 

XI 

(2) 


Z2M 

X2 

(3) 


Z3M 

X3 


Table 2 Lumped mass attributes 
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SUPERTAB 1 

IMAT 

MSC/NASTRAN 2 

GROUP NUMBER 

CMPONENT 

— 

ELEMENT NUMBER 

ELEMENT 

EID 

NODE 1 (fore end) 

NODE1 

GA 

NODE 2 (aft end) 

NODE2 

GB 

— 

EL-TYPE 

— 

PHYS. PROP. NUM. 

NOM-SIZE 

PID 

MAT. PROP NUM. 

MATERIAL 

MID 

— 

BMREFER 

— 

NS ML 

NONSTWHB 

NSM 

OFVF (1) 

Z1A 

W 1 A 

(2) 

Z2A 

W2A 

(3) 

Z3A 

W3 A 

OFVA (1) 

Z1B 

W1B 

(2) 

Z2B 

W2B 

(3) 

Z3B 

W3B 

RFE 

PA 

PA 

RAE 

PB 

PB 

BOS 3 ( 1 ) 

X 

XI 

(2) 

Y 

X2 

(3) 

Z 

X3 

(1) 

NODEREF 

GO 

177 

I 1 

I 1 

IYY 

12 

I 2 

1/SRY 4 

ALPHA 1 

K1 

1/SRZ 4 

ALPHA2 

K2 

AR 

AREA 

A 

TC 

FF 

J 

IXY 

1 1 2 A 

112 


Table 3 Beam attributes 
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MSC/NASTRAN 

Grid Point Weight Generator IMAT (RIGPROP^ 


MO (1,1) 

MASSMAT 

(1,1) 

(row 1) 

" (1,2) 

tt 

(1,2) 

" 2 

" (1,3) 

it 

(1,3) 

" 3 

” (2,1) 

it 

(2,1) 

" 4 

" (2,2) 

it 

(2,2) 

" 5 

" (2,3) 

tt 

(2,3) 

" 6 

" (3,D 

tt 

(3,1) 

" 7 

" (3,2) 

tt 

(3,2) 

" 8 

" (3,3) 

it 

(3,3) 

” 9 

I(S) (1,1) 

MASMOMIN (1,1) 

(row 1) 

- I(S) (1,2) 

tt 

(1,2) 

" 2 

- I(S) (1,3) 

tt 

(1,3) 

" 3 

- I(S) (2,1) 

it 

(2,1) 

" 4 

I(S) (2,2) 

it 

(2,2) 

" 5 

- I (S) (2,3) 

tt 

(2,3) 

" 6 

- ICS) (3,1) 

ii 

(3,1) 

" 7 

- ICS) (3,2) 

tt 

(3,2) 

" 8 

ICS) (3,3) 

tt 

(3,3) 

" 9 

X-CG 

CG(1) 


Y-CG 

CG (2) 


Z-CG 

CG (3) 


Table 4 Rigid-body 

mass attributes 
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NOTES: 


1. SDRC I DEAS SUPERTAB USER'S MANUAL, Level 4 

2. MSC/NASTRAN USER’S MANUAL, Version 65c 

3. SUPERTAB allows either a node or a set of xyz offsets 
to be used as an orientation specification. IMAT 
supports the following orientation codes and 
specifications: 


CODE 


SPECIFICATION 


1 

3 

4 


x, y, z offset 
reference node 
x, y, z offset 


4. Note that the Shear Stiffness Factors (SRY and SRZ) 
specified in SUPERTAB are the inverse of the factors 
(K1 and K2) that MSC/NASTRAN uses. The IMAT 
LOAD UNIVERSAL FILE processor will automatically 
invert SRY and SRZ before storing them as ALPHA 1 
and ALPHA2. 
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LOAD BULK DATA 1 


PROCESSOR: LOAD BULK DATA 

PURPOSE: The LOAD BULK DATA processor transfers bulk data 

from a fixed format MSC/NASTRAN bulk data deck to a user 
specified IMAT-defined RIM database. 

ENTERING THE NAMES OF THE DATABASE AND BULK DATA FILE: 

You will be asked to enter the names of the database and the bulk 
data file to be used with this processor. These files must reside in 
your current directory. The processor makes no attempt to copy files 
from other directories. Entering END at this point will cause you to 
exit from the processor and return to the IMAT EXECUTIVE. 

LOADING THE DATA: 

Data from the bulk data file will be loaded into the following 
IMAT-defined relations: ° 

1. Grid points will be loaded into relation NODES. 

2. MSC/NASTRAN elements will be loaded into relations 
BEAMS, QUADS, TRIANGLS, and RIGIDBAR. 

3. Section properties for beams and rods will be loaded into relation 
BEAMPROP. 

4. Beam orientations will be loaded into relation BEAMREF. 

5. Material properties will be loaded into relation MAT-PROP. 

6. Single point constraints will be loaded into relation CONSTRN. 

7. Concentrated masses will be loaded into relation CONMASS. 

8. Element pressure loads will be loaded into relation ELEMLOAD. 

9. Concentrated forces and moments will be loaded into relation 
NODELOAD. 

NASTRAN ELEMENTS vs. RIM ELEMENTS: 

The processor will match MSC/NASTRAN element types with generic 
element types used in the IMAT relations and insert these element 
types in the appropriate connectivity relations. 
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LOAD BULK DATA 2 


SUPPORTED BULK DATA CARDS: 

name four character abbrevation 


CBAR 

CBEA 

CONM2 

CONROD 

CQUAD 

CROD 

CSHEAR 

CTRIA 

FORCE 

GRID 

MAT1 

MOMENT 

PBAR 

PLOAD 

PROD 

PS HEAR 

RBAR 

SPC1 


CBAR 

CBEA 

CONM 

GONR 

CQUA 

CROD 

CSHE 

CTRI 

FORC 

GRID 

MAT1 

MOME 

PBAR 

PLOA 

PROD 

PSHE 

RBAR 

SPC1 


ERROR HANDLING: 

If a particular data set requested is not present in the bulk data file, 
a message is issued to that effect. The program will then continue by 
loading the next selection. If an error occurs during the processing 
(i.e., missing relation, error retrieving data, unmatched element type, 
etc.), the program will inform you of the error and give you the 
options of continuing to process the remaining data requested or 
returning to the IMAT EXECUTIVE. 
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FORMAT BULK DATA 1 


PROCESSOR: FORMAT BULK DATA 

PURPOSE: The FORMAT BULK DATA processor creates a complete 

MSC/NASTRAN Solution 3 data deck for use in computing the Normal 
Modes of a structure using the Lanczos method. 


ENTERING THE FILE NAMES: 

You will be asked to enter the name of the database to be used with 
this processor. The database must reside in your current directory. 
The processor makes no attempt to copy files from other directories. 
Entering END at this point will cause you to exit from the processor 
and return to the IMAT EXECUTIVE. 

Next, you will be asked to enter the password for the database or a 
carriage return to indicate the default password, NONE. If an error 
occurs, you will be given a chance to enter a different database 
name. 

You now will be asked to enter a name for the MSC/NASTRAN bulk 
data deck which the program will create for you. A carriage return 
will give the file the default name, NASBLK. 

ENTERING THE MAXIMUM FREQUENCY OF INTEREST: 


You will be asked to enter the maximum frequency of interest (Hz). 
EX: 2.0 All undamped natural frequencies below this value will be 

computed. 
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FORMAT BULK DATA 2 


ERROR HANDLING: 

If an error occurs at any stage of the processing (i.e., missing relation, 
error retrieving data, element mismatch, etc.), the program will 
inform you of the error and give you the option to continue 
processing or to quit. Should you choose to quit, you will return to 
the IMAT EXECUTIVE. The partial bulk data deck that was created 
will remain in your directory. 

CHOOSING THE CONSTRAINED DEGREES OF FREEDOM: 

This option allows you to delete rigid-body degrees of freedom (DOF) 
from the solution by specifying the deleted DOF, one at a time, using 
the following menu: 

FORMAT BULK DATA: CONSTRAINED DEGREES OF FREEDOM MENU 
CHOOSE THE CONSTRAINED DEGREES OF FREEDOM DESIRED: 

1 . X - DIRECTION 

2. Y - DIRECTION 

3. Z- DIRECTION 

4. X - ROTATION 

5. Y - ROTATION 

6. Z- ROTATION 

7. BEGIN PROCESSING 

Select the options one at a time, or menu item 7 to continue with the 
processing. The program will write the appropriate GRDSET card to 
the bulk data deck. 

PROCESSING THE DATA: 

The program now proceeds to process the data in your database and 
create the bulk data deck. The data types will be processed 
in the following order: 
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1. Material property data from relations MAT-PROP and 
SCRREL 

2. Joint location data from relation NODES 

3. Node constraint data from relation CONSTRN 

4. Element connectivity data from relations SCRREL and 
BEAMREF 

5. Sectional property data from relations SCRREL and 
BEAMPROP 

6. Concentrated mass data from relation CONMASS 
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EXECUTE MSC/NASTRAN 1 


PROCESSOR: EXECUTE MSC/NASTRAN 

PURPOSE. The EXECUTE MSC/NASTRAN processor will generate a 
submit file for MSC/NASTRAN. 

ENTERING THE NAME OF YOUR MSC/NASTRAN INPUT FILE: 

The program will ask you to enter the name of your MSC/NASTRAN 
input file. The MSC/NASTRAN deck must reside in your current 
directory. The processor makes no attempt to copy files from other 
directories. If you enter a carriage return for any item, the program 
will give you a chance to exit the processor or to reenter that item. 

ENTERING MSC/NASTRAN OPTIONS : 

The program will display the following menu : 

EXECUTE MSC/NASTRAN: OPTIONS MENU 

CHOOSE THE OPTIONS DESIRED FOR THIS RUN 

(NOTE: THE PLOT FILE AND OUTPUT FILE ARE SAVED FOR 
EVERY RUN) 

1 . USE OLD PROBLEM TAPE FOR RESTART RUN 

2. USE UTILITY FILES FOR RESTART RUN 

3. SAVE RESULTING UTILITY FILES 

4. CONTINUE PROCESSING [DEFAULT] 

Option 1 and option 2 allow you to use an Old Problem Tape (OPTP) 
and/or utility files that were created by a previously executed 
MSC/NASTRAN analysis. Option 3 provides the capability to save the 
utility files created by this analysis. You will be asked to enter 
names for each of the files you want to save. Option 4 will allow you 
to enter the required information for the MSC/NASTRAN execution 
command. 
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EXECUTE MSC/NASTRAN 2 


VERIFYING THE SUBMIT FILE: 

The program will display the information and ask if it is correct. If 
you indicate that any of the information is incorrect, the program 
will give you the opportunity to reenter the information. If you 
choose not to reenter the information, you will return to the IMAT 
EXECUTIVE. 


SUBMITTING THE BATCH FILE: 

The processor will submit your MSC/NASTRAN job to the 
NAS$BATCH queue by default. If you want to submit your job to a 
different queue, you may indicate the desired queue at the prompt: 

ENTER THE QUEUE TO WHICH THE NASTRAN JOB IS TO BE SUBMITTED 
[DEFAULT=NAS$BATCH] 

TERMINATION: 

After you specify the appropriate queue, your MSC/NASTRAN job 
will be placed on that queue for execution. The processor will ask if 
you want to submit more MSC/NASTRAN jobs and if not, the 
processor will return you to the IMAT EXECUTIVE. 
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LOAD ANALYSIS RESULTS 1 


PROCESSOR: LOAD ANALYSIS RESULTS 

PURPOSE. The LOAD ANALYSIS RESULTS processor transfers 
analysis data from MSC/NASTRAN to a user specified IMAT-defined 
RIM database. 

ENTERING THE NAME OF THE DATABASE: 

You will be asked to enter the name of the database to be used with 
this processor. The database must reside in your current directory. 
The processor makes no attempt to copy files from other directories. 
Entering END at this point will cause you to exit from the processor 
and return to the IMAT EXECUTIVE. 

Next, you will be asked to enter the password for the database or a 
carriage return to indicate the default password, NONE. If an error 

occurs, you will be given a chance to enter a different database 
name. 


CHOOSING AND LOADING THE DATA: 

The program will display: 

LOAD ANALYSIS RESULTS: ANALYSIS DATA MENU 

1. STRAIN ENERGIES 

2. RIGID PROPERTIES 

3. VIBRATIONAL EIGENVECTORS 

4. BEGIN LOADING 

It you choose option 1 and/or option 3, you will be asked to enter 
the name of the PUNCH file that contains the corresponding data. 
This file must also reside in your current directory. Enter option 4 
after you have chosen all the data types desired. 


FINITE ELEMENT 


5-17 


LOAD ANALYSIS RESULTS 2 


ANALYSIS DATA MENU OPTION 2: RIGID PROPERTIES 

If option 2 (RIGID PROPERTIES) is selected, you will be prompted for 
the name of the (binary) output file that contains the rigid body 
mass properties. (The FORMAT BULK DATA processor will write the 
alter needed to obtain this information from MSC/NASTRAN's Grid 
Point Weight Generator.) 

ANALYSIS DATA MENU OPTION 3: VIBRATIONAL EIGENVECTORS 

Enter the number of eigenvectors that you desire to load into the 
database. This option allows you to load, for example, the first n 
eigenvectors into the database. 

NOTE: The eigenvectors must have been normalized such that the 
generalized mass is unity for each mode. MSC/NASTRAN s Lanczos 
method automatically performs this "mass normalization". 


ERROR HANDLING: 

If an error occurs during the processing (i.e., missing relation, error 
retrieving data, unmatched element type, etc.), the program will 
inform you of the error and give you the option of continuing to 
process the remaining data requested or returning to the IMAT 
EXECUTIVE. 
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RECOVER PHYSICAL OUTPUT 1 


PROCESSOR: RECOVER PHYSICAL OUTPUT 


PURPOSE: The RECOVER PHYSICAL OUTPUT processor enables a 

user to recover physical output using MSC/NASTRAN from a state- 
space time simulation calculated using MATRIXx/SYSTEM_BUILD. 

MAIN MENU OPTIONS: 

When you first enter the RECOVER PHYSICAL OUTPUT processor, you 
will see the MAIN MENU which offers options to let you generate a 
complete bulk data deck, plot commands only, or a MSC/NASTRAN 
modal solution (UHV) matrix. To exit the program at any time, enter 
Q from this or any menu: 

RECOVER PHYSICAL OUTPUT: MAIN MENU 

CHOOSE THE FUNCTION DESIRED OR ”Q" TO QUIT: 

1 . GENERATE COMPLETE BULK DATA DECK [DEFAULT] 

2 . INSERT NEW PLOT COMMANDS INTO EXISTING DECK 

3. GENERATE NEW PLOT COMMANDS ONLY 

4. GENERATE MSC/NASTRAN UHV MATRIX FROM MATRIXX MODAL 
OUTPUT FILES 

MAIN MENU OPTION 1: GENERATE COMPLETE BULK DATA 
DECK 

Option 1 will generate a new MSC/NASTRAN data deck for a modified 
Solution 31 transient analysis restart. 

LOCATING YOUR DATA: 

The program will first prompt you to enter the name of your 
database. If your database is not in your current default directory, 
you will be prompted to enter the pathname to the directory where 
the database is located. Enter a VMS pathname for the directory, not 
including the file name ( EX: DUAO:[MYDIR.SUBDIR] ). 
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RECOVER PHYSICAL OUTPUT 2 


The program will now display a menu of the control simulations which have 
been recorded in your database (See RECORD CONTROL SIMULATION processor) 

RECOVER PHYSICAL OUTPUT: SIMULATIONS MENU 

FOR WHICH SIMULATION SHOULD THIS DECK BE CREATED? 


SIMUL.ID 

SYSTEM ID 

DESCRIPTION 


1 

1 

Description entered 
simulation 1 

for 

2 

1 

Description entered 

for 

3 


simulation 2 



After you select the simulation desired, the RECOVER PHYSICAL 
OUTPUT processor will present a summary of the simulation and let 
you verify that this is the simulation intended. 

The program will now attempt to locate the PUNCH file containing the 
checkpoint dictionary from the normal modes analysis and load time 
history files recorded in your database for this simulation. If a file 
cannot be located in the current directory, you will be prompted to 
enter an alternate pathname for the file. 

(EX: DU A0:[MYDIR. MYSUBJMYFILE.DAT ) 

The program will allow you to continue generating a restart deck if 
the PUNCH file is missing; however, you must be able to locate time 
history files for all loads defined in the simulation record. 

The RECOVER PHYSICAL OUTPUT processor will now present a 
summary of the modes used in the control simulation compared to 
the modes calculated in the finite element normal modes analysis. 

INITIALIZING THE CASE CONTROL DECK: 
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The RECOVER PHYSICAL OUTPUT processor will now generate the 
initial commands for the MSC/NASTRAN Executive Case Control Decks 
and will prompt you to enter a title and a subtitle for this analysis 
(maximum of 70 characters each). If you answer YES to the DMAP 
option, your MSC/NASTRAN output will contain a DMAP listing. You 
will also be prompted to enter the set ID that was used in the EIGR or 
EIGRL card in the normal modes analysis, and if your database 
contains single point constraints, the program will also prompt you 
for the SPC set number. 

DEFAULT PLOT PARAMETERS: 


The program will now display the default plot parameters which will 
apply to all plot commands generated by this processor: 

RECOVER PHYSICAL OUTPUT: PLOT PARAMETER MENU 

CHOOSE ANY OF THE CURRENT DEFAULT PLOT PARAMETERS WHICH 
YOU WOULD LIKE TO CHANGE. THESE PARAMETERS WILL APPLY TO 
ALL PLOTS GENERATED. 


1 . XPAPER = 20.0 

9. 

LEFT TICS = 1 

2. YPAPER = 20.0 

10. 

RIGHT TICS = 0 

3. XAXIS = YES 

11 . 

XDIVISIONS = 10 

4. YAXIS = YES 

12. 

YDIVISIONS = 10 

5. XVALUE SKIP PRINT = 0 

13. 

XGRID LINES = YES 

6. Y VALUE SKIP PRINT = 0 

14. 

YGRID LINES = YES 

7. LOWER TICS = 1 

15. 

XTITLE = TIME, SECONDS 

8. UPPER TICS = 0 

16. 

ACCEPT CURRENT 
PARAMETERS 


Choose the parameters that you wish to change one at a time, then 
select option 16 to accept the parameters you have defined. These 
parameters, summarized below, are fully explained in the 
MSC/NASTRAN USER'S MANUAL (Vol. II, 4.3.2): 

XPAPER Plot paper width 

YPAPER Plot paper height 
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XAXIS 

YAXIS 

X VALUE SKIP PRINT 

Y VALUE SKIP PRINT 

LOWER TICS 
UPPER TICS 
LEFT TICS 
RIGHT TICS 
XDIVISIONS 
YDIVISIONS 
XGRID LINES 

YGRID LINES 

XTITLE 


Request to plot X-axis (YES/NO) 

Request to plot Y-axis (YES/NO) 

Number of X-values to skip between labelled 
tic marks 

Number of Y-values to skip between labelled 
tic marks 

Request for tic marks on lower edge of frame 

Request for tic marks on upper edge of frame 

Request for tic marks on left edge of frame 
Request for tic marks on right edge of frame 
Number of uniform spaces in X-direction 
Number of uniform spaces in Y-direction 
Request for grid lines parallel to Y-axis 
(YES/NO) 

Request for grid lines parallel to X-axis 
(YES/NO) 

Label for X-axis 


PLOT REQUEST MENU: 


The RECOVER PHYSICAL OUTPUT 
REQUEST MENU: 


processor will now display the PLOT 


RECOVER PHYSICAL OUTPUT: PLOT REQUEST MENU 
ENTER THE PLOT TYPES DESIRED FOR THIS ANALYSIS: 


1 . 

2 . 

3 . 

4 . 

5 . 


DYNAMIC LOAD PLOTS 

MODAL DISPLACEMENT, VELOCITY, ACCELERATION PLOTS 
PHYSICAL DISPLACEMENT, VELOCITY, ACCELERATION PLOTS 
ELEMENT FORCE, STRESS PLOTS 
CONTINUE PROCESSING [DEFAULT] 


fhe e MsX°A S TP 1 : !T,“ 8h t n f nera,e the p ' 01 commands d«ired for 
the MSC/NASTRAN data deck, followed by option 5 which will 

continue processing by completing the final commands required for 

the deck This menu will also display the total number of plots 

generated as you complete each menu choice. 
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PLOT REQUEST MENU CHOICE 1 : DYNAMIC LOAD PLOTS 

This option will allow you to define plots of applied loads at selected 
nodes or ranges for nodes. The same information will be plotted for 
all nodes in each range you specify. For each node or range of nodes 
you enter (a), you will be asked to define the components (b), and the 
scaling desired (c) for the plots. 

(a) The program will first prompt you to enter a node or range of 
nodes for plots. Enter an individual node number or a range of nodes 
(EX: 200 or 200-201), or a carriage return if you have defined all load 
plots desired and wish to return to the PLOT REQUEST MENU. 

(b) For each set of plots you request, you will be asked to enter the 
components desired: 

RECOVER PHYSICAL OUTPUT: COMPONENT MENU 

1. TRANSLATION-X 

2. TRANSLATION-Y 

3. TRANSLATION-Z 

4. ROTATION-X 

5. ROTATION- Y 

6. ROTATION-Z 

ENTER COMPONENTS DESIRED (1-6) FOR LOAD PLOTS FOR NODES 
200-201. (SEPARATE EACH COMPONENT OR RANGE WITH COMMAS 1 
EX: 1,3-5 (OR) 1,2,3 

Enter the components desired separated by commas. You may 
indicate a range with a dash. 

(c) After you have selected the components for this set of plots, the 
program will ask you to define the scaling desired: 

DO YOU WANT MSC/NASTRAN TO PROVIDE AUTOMATIC SCALING OF 
DATA? [Y]/N 

If you choose MSC/NASTRAN automatic scaling (Y), there will be no 
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minimum or maximum X or Y value set. If you decide to scale the 
data yourself (N), you will be shown the X/Y MINIMUM/MAXIMUM 
VALUES MENU: 

RECOVER PHYSICAL OUTPUT: X/Y MINIMUM/MAXIMUM VALUES 
CHOOSE OPTIONS 1 -4 TO CHANGE CURRENT DEFAULTS: 

1. XMIN = NONE 

2. XMAX = NONE 

3. YMIN = NONE 

4. YMAX = NONE 

5 . ACCEPT ABOVE DEFAULTS [DEFAULT] 

Choose one at a time the minimum or maximum value you want to 
change. Enter a new value at the prompt or a carriage return to 
indicate no minimum or maximum: 

NEW VALUE FOR XMIN [<CR> = 'NONE']: 

The program will show you the menu again, reflecting the current 
values you have entered. When you are satisfied with the 
minimum/maximum values you have set, select option 5. 

The program will now display a table of the plots you have selected 
for these nodes: 

PLOTS REQUESTED FOR NODES 200-201: 

COMPONENTS 1 2 3 

XMIN: 1 00E+03 XMAX: +.100E+03 

YMIN: NONE YMAX: NONE 

GENERATE THE PLOTS LISTED ABOVE? [Y]/N 

If you agree with the plots chosen (Y), the program will write all of 
the plot commands necessary to generate these plots. If you want to 
make changes to the plots requested (N), the program will return you 
to the prompt for node numbers to define a different set of plots. 
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From this point on, whenever you enter a new node or range of nodes 
for plots, the program will display the current default plots which are 
the set of plots chosen for the last node range. You may choose these 
same plots for the new range or node, or define a different set. Enter 
a carriage return at the prompt for nodes to complete all load plots 
and return to the PLOT REQUEST MENU. 

PLOT REQUEST MENU CHOICE 2: MODAL DISPLACEMENT VELOCITY 
ACCELERATION PLOTS 

This option will allow you to define displacement, velocity, and 
acceleration plots for modes or ranges of modes. The same 
information will be plotted for all modes in each range you specify. 

For each mode or range of modes you enter (a), you will be asked to 
define the output types (b), the components desired for each output 
type (c), and the scaling desired (d) for the plots. 

(a) The program will first prompt you to enter a mode or range of 
modes for plots. Enter an individual mode number or a range of 
modes (EX: 10 or 6-10), or a carriage return if you have defined all 
modal plots desired and wish to return to the PLOT REQUEST MENU. 

(b) You will now see the MODAL PLOT OUTPUT MENU: 

RECOVER PHYSICAL OUTPUT: MODAL PLOT OUTPUT MENU 
ENTER OUTPUT TYPES DESIRED ONE AT A TIME FOR MODES 6-10: 

1. DISPLACEMENT 

2. VELOCITY 

3. ACCELERATION 

4 . CANCEL PLOTS FOR THESE MODES 

5 . CONTINUE PROCESSING [DEFAULT! 

Choose one at a time the output types desired for these modes. Select 
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option 5 to continue processing after you have chosen the output 
types desired. Option 4 will cancel all the plots you have selected for 
these modes and return you to the prompt to enter a new mode range 
(a). 

(c) For each output type you request, you will be asked to enter the 
components desired: 

RECOVER PHYSICAL OUTPUT: COMPONENT MENU 

1. TRANSLATION-X 

2. TRANSLATION-Y 

3. TRANSLATION-Z 

4. ROT ATI ON -X 

5. ROTATION-Y 

6. ROTATION-Z 

ENTER COMPONENTS DESIRED (1-6) FOR DISPLACEMENT PLOTS FOR 
MODES 6-10. (SEPARATE EACH COMPONENT OR RANGE WITH 
COMMAS.) 

EX: 1,3-5 (OR) 1,2,3 

Enter the components desired separated by commas. You may 
indicate a range with a dash. You may change the components 
selected for an output type by reselecting that type from the MODAL 
PLOT OUTPUT MENU and choosing different components (<CR> for 
NONE) as the program will record only the last set of components 
selected for each output type for any set of modes. 

(d) After you have selected all of the output types for these modes 
(and entered option 5 from the MODAL PLOT OUTPUT MENU), the 
program will ask you to define the scaling desired for this set of plots: 

DO YOU WANT MSC/NASTRAN TO PROVIDE AUTOMATIC SCALING OF 
DATA? [Y]/N 
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If you choose MSC/NASTRAN automatic scaling (Y), there will be no 
minimum or maximum X or Y values set. If you decide to scale the 
data yourself (N), you will be shown the X/Y MINIMUM/MAXIMUM 
VALUES MENU and be asked to set X and Y minimum and maximum 
values by the same method used with Load plots (See section c under 
LOAD PLOTS above). 

The program will now display a table of the plots you have selected 
for these modes: 

PLOTS REQUESTED FOR MODES 6-10: 

DISPLACEMENT 1 2 3 
VELOCITY 

ACCELERATION 1 2 4 5 6 

XMIN: . 1 00E+03 XMAX: +.100E+03 

YMIN: NONE YMAX: NONE 

GENERATE THE PLOTS LISTED ABOVE? [YJ/N 

If you agree with the plots chosen (Y), the program will write all of 
the plot commands necessary to generate these plots. It you want to 
make changes to the plots requested (N), the program will return you 
to the MODAL PLOT OUTPUT MENU to define a different set of plots. 

From this point on, whenever you enter a new mode or range of 
modes for plots, the program will display the current default plots 
which are the set of plots chosen for the last mode range. You may 
choose these same plots for the new range or modes, or define a 
different set. Enter a carriage return at the prompt for modes or 
mode range to complete all modal plots and return to the PLOT 
REQUEST MENU. 

PLOT REQUEST MENU CHOICE 3: PHYSICAL DISPLACEMENT, 
VELOCITY. ACCELERATION PLOTS 
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This option will allow you to define displacement, velocity, and 
acceleration plots for nodes or ranges of nodes. The same information 
will be plotted for all nodes in each range you specify. The set of 

menus for physical plots exactly parallels those under PLOT RFOTTFST 
MENU CHOICE 2 (MODAL PLOTS): REQUEST 

PHYSICAL PLOT OUTPUT MENU (to select output types) 

COMP° NENT MENU (to select components desired for each output 

X/Y MINIMUM/MAXIMUM VALUES MENU (to define minimum or 
maximum X or Y values) 

(See the documentation for modal plots above for specific 
instructions.) Enter a carriage return at the prompt for nodes or 

an ? e t,T°Jv nodes t0 com plete all displacement plot requests and return 
to the PLOT REQUEST MENU. ^quests and return 

PLOT REQUEST MENU CHOICE 4: ELEMENT FORCE, STRESS PLOTS 

This option will allow you to define force and stress plots for specific 

i ° r ra " SeS ° f elemen,s - The same information will be plotted 
for all elements .n each range you specify. For each range you define 

If'the el , en / e , r ,h * ekment ty P e (b >' & ive an optional description 

des red e) a"nd 'h' plots desired «■). choose stress plots 

desired (e). and have an opportunity to use MSC/NASTRAN automatic 

scaling or to define you own scaling for data (f). 

(a) The program will first prompt you to enter an element number or 

range of element numbers. oer or 

(b) You will then be prompted to enter the MSC/NASTRAN element 

type for the element or element range: element 

RECOVER PHYSICAL OUTPUT: ELEMENT TYPE MENU 
ENTER ELEMENT TYPE FOR ELEMENT 200: 
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1. BAR 

2. BEAM 

3. ROD 

4. QUAD4 

5. TRIA3 

6 . CANCEL PLOTS FOR THESE ELEMENTS 

Enter the MSC/NASTRAN element type or option 6 to cancel these 
plots. 

(c) You will now be prompted to enter an optional description for this 
element or range of elements: 

ENTER A DESCRIPTION FOR THIS ELEMENT (MAX 37 CHAR) 
[OPTIONAL]: 


Any description you enter will be used in the TCURVE command for 
this set of plots. Enter a carriage return if you do not want to use a 
description. 

(d) and (e) You will now be shown first a menu of the force plots 
supported for this element type and then a menu of the supported 
stress plots (See MSC/NASTRAN USER'S MANUAL, VOLUME II for a 
description of each plot type.) 

EXAMPLE MENU: 

RECOVER PHYSICAL OUTPUT: FORCE PLOTS FOR BAR ELEMENTS 
ENTER PLOTS DESIRED ONE AT A TIME FOR ELEMENT 200: 

1 . BENDING MOMENT, PLANE 1 (END A) 

2. BENDING MOMENT, PLANE 2 (END A) 

3 . BENDING MOMENT, PLANE 1 (END B) 

4 . BENDING MOMENT, PLANE 2 (END B) 

5. SHEAR FORCE, PLANE 1 

6 . SHEAR FORCE, PLANE 2 

7. AXIAL FORCE 

8. TORQUE 

FINITE ELEMENT 90 
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9. CANCEL FORCE PLOTS SELECTED FOR THESE ELEMENTS 

1 0 . CANCEL ALL PLOTS SELECTED FOR THESE ELEMENTS 

1 1 . CONTINUE PROCESSING [DEFAULT] 

As you enter the plots desired (one at a time), the program will mark 
your choices with an asterisk to the left of the option number. In this 
example menu, option 9 would cancel all of the force plots you have 
selected (i.e., clear all the asterisks) and allow you to select a 
different set of force plots. Option 10 would cancel all plots chosen 
for these elements and return you to the prompt to enter a new 
element range. Option 11 would, in this case, pass you on to the 
stress plot menu to complete the plot selection phase and continue to 
the MSC/NASTRAN automatic scaling option. 

(f) After you have selected all of the plots desired, you will be given 
a chance to select MSC/NASTRAN automatic scaling or to define your 
own X or Y minimum or maximum values. (See the discussion of X/Y 
MINIMUM/MAXIMUM VALUES under PLOT REQUEST MENU CHOICE 
2 (MODAL PLOTS)). The program will now write to the data deck all 
of the commands required to generate the element plots requested. 
Enter a carriage return at the request for element number or range, 
when you have completed all the element plots desired. You will 
return to the PLOT REQUEST MENU. 

FINISHING THE BULK DATA DECK: 

After you have selected all of the plots desired (Enter option 5 
[CONTINUE PROCESSING] from the PLOT REQUEST MENU ), the 
program will write the final commands appropriate to your 
MSC/NASTRAN data deck including the TABLED1 cards to be 
formatted from the controls time history files. To execute 
MSC/NASTRAN with this data deck, use the EXECUTE MSC/NASTRAN 
processor. This processor will give you the opportunity to retrieve 
any files necessary to perform a MSC/NASTRAN restart to complete 
this closed-loop transient analysis. Before executing MSC/NASTRAN, 
use OPTION 4 from the MAIN MENU of this program to create your 
MSC/NASTRAN modal solution (UHV) matrix from the MATRIXx 
modal output (state-space solution) files. 
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MAIN MENU OPTION 2: INSERT NEW PLOT COMMANDS INTO 
EXISTING DECK 

This option will allow you to define new plot commands to be 
inserted into an existing deck previously created using option 1. A 
new version of your deck will be created in which the plot commands 
you define replace the plot commands in the original deck. Your 
original deck will not be altered. This option will only work with a 
deck created using option 1 from the main menu. 

You will first be prompted to enter the name of your existing bulk 
data deck and a name for the new deck to be created. You will then 
be allowed to reset the default plot parameters (See DEFAULT PLOT 
PARAMETERS under option 1) and to define new plot commands (See 
PLOT REQUEST MENU under option 1) much as you would when 
generating a complete deck from the database. When you complete 
your plot choices, the plot commands you defined will be inserted 
into a copy of your original deck. 

MAIN MENU OPTION 3: GENERATE NEW PLOT COMMANDS 
ONLY 

Option 3 will allow you to generate plot commands only. This option 
does not require that you have a bulk data deck present. As in 
option 2, you will enter a file name for your plot commands and then 
will define plot parameters and plot commands as you do under 
option 1. 

MAIN MENU OPTION 4: GENERATE MSC/NASTRAN UHV 

MATRIX FROM MATRIXX MODAL OUTPUT FILES 

Option 4 will allow you to generate a MSC/NASTRAN modal solution 
(UHV) matrix from the three modal output files recorded in your 
database. You will first select the database and simulation. If you 
have previously selected a database and simulation, these will be the 
default choices. The program will now locate the MATRIXx modal 
output files defined in your database for this simulation. If the files 
are not located in the current directory, you will be given an 
opportunity to enter an alternate pathname for each file. 

FINITE ELEMENT 5-3 1 


RECOVER PHYSICAL OUTPUT 14 


The program will now create a MSC/NASTRAN modal solution (UHV) 
matrix from the modal output data in these files. When executing a 
MSC/NASTRAN restart using a bulk data deck from option 1, be 
certain to define this UHV matrix file as FORTRAN unit 15 (FOR015). 
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PROCESSOR: EXECUTE SUPERTAB/GEOMOD 

PURPOSE: The EXECUTE SUPERTAB/GEOMOD processor allows the 

user to access the available SDRC I-DEAS modules. The user must be 
familiar with I-DEAS commands in order to execute this processor. 

ENTERING YOUR TERMINAL TYPE: 

At the beginning of execution, I-DEAS will prompt you for your 
terminal type. Enter the correct code for your graphics terminal or 
an M to see a menu of terminal types supported. 

ON-LINE HELP: 

ON-line help is featured as a global command in I-DEAS. For further 
information, consult the I-DEAS USER'S GUIDE, or enter the HELP 
command from within I-DEAS. 

RETURNING TO THE IMAT EXECUTIVE: 

Upon completion of I-DEAS, you will be returned to the IMAT 
EXECUTIVE. 
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PROCESSOR: LOAD UNIVERSAL FILE 


PURPOSE. The LOAD UNIVERSAL FILE processor reads the 
Un ,ve rs a file created during a SUPERTAB session and loads the data 
into an IMAT-deftned RIM database. This database contains the 
complete description of a particular finite element model. The 
processor supports the following data set types: 

DATA SET TYPE DESCRIPTION 


1 5 
7 1 
73 1 
747 
752 

755 

756 


Node Data 

Connectivity Data 

Physical Property Value Entries 

Material Property Value Entries 

Permanent Group Data 

Restraint Data 

Load Set Data 


ENTERING YOUR DATABASE NAME: 

You will be asked to enter the name of the database to be used with 

The P rocessor ' e debase must be in your current directory 
The processor makes no attempt to copy databases from other 
directories. Entering END at this point will allow you to exit the 
processor and return to the IMAT EXECUTIVE 

You will next enter the password for the database or a carriage 
return to indicate the default password, NONE. The program will now 
pen your database and if an error occurs, you will have the chance 
to enter a different database name or exit the processor. 

ENTERING THE UNIVERSAL FILE NAME: 

You will be asked to supply the name of the SUPERTAB Universal 
your cu^re^^dt^c^ry . retri6Ve ^ ^ ** y ° U * k is n0t alread y in 
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PROCESSOR LOG FILE: 

Many descriptive messages concerning the data in your Universal 
file may be generated during the execution of LOAD UNIVERSAL 
FILE. The processor will give you the opportunity to keep a log file 
of these messages. If you choose to create a log file, you will be 
asked to enter a name for the log file or you may use the default 
name offered. 

SELECTING DATA SET TYPES FROM THE DATA SET MENU: 

The program will now show you: 

LOAD UNIVERSAL FILE: DATA SET MENU 

ENTER DATA SET TYPES TO BE TRANSLATED INTO RIM: 


CHOICE (DATA SET TYPE) DESCRIPTION 


1 . 

(15) 

NODE DATA 

2. 

(71) 

CONNECTIVITY DATA 

3. 

(731) 

PHYSICAL PROPERTY VALUE ENTRIES 

4. 

(747) 

MATERIAL PROPERTY VALUE ENTRIES 

5. 

(752) 

PERMANENT GROUP DATA 

6. 

(755) 

RESTRAINT DATA 

7. 

(756) 

LOAD SET DATA 

8. 


ALL SUPPORTED DATA SET TYPES 

9. 


BEGIN PROCESSING 


Enter option 8 if you would like to load all supported data set types 
into your database; otherwise choose the data set types you want 
one at a time, followed by option 9 to begin the processing. 
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PROCESSING THE DATA: 

The processor will now read through the Universal data file and load 
each data set type requested. It will inform you of each data set 
found with one of three messages, as appropriate: 

LOADING DATA SET TYPE xx 

UNSUPPORTED DATA SET IN UNIVERSAL FILE IGNORED 
DATA SET TYPE: xx 


NON-REQUESTED DATA SET IN UNIVERSAL FILE 
IGNORED DATA SET TYPE: xx 

If an error occurs during the processing (i.e., missing relation, 
unmatched element type, etc.), the program will inform you of the 
error but continue with the processing. After processing the 
Universal file, the program will remind you of the log file name if 
you chose to generate one, and then return you to the IMAT 
EXECUTIVE. 


PROCESSING ORDER: 

Connectivity Data (Data Set 71) requires property value data from 
Data Set 731 (Physical Property Value Entries) in order to be 
correctly loaded into the database. In addition, Permanent Group 
Data (Data Set 752) refers to element numbers loaded from Data Set 
71. The LOAD UNIVERSAL FILE processor will not load either Data 
Set 71 or Data Set 752 unless its required predecessor was also 
loaded. 
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PROCESSOR: FORMAT UNIVERSAL FILE 

PURPOSE: The FORMAT UNIVERSAL FILE processor formats finite 

element model and analysis data stored in an IMAT-defined RIM database 
into a SUPERTAB (4.0) Universal file. The processor supports the following 
data set types: 


CTA SET TYPE 

DESCRIPTION 



1 5 

Node Data 



55 

Data at Nodes 



7 1 

Connectivity Data 



73 1 

Physical Property 

Value 

Entries 

747 

Material Property 

Value 

Entries 

752 

Permanent Group 

Data 


755 

Restraint Data 



756 

Load Set Data 




ENTERING YOUR DATABASE NAME: 

You will be asked to enter the name of the database to be used with this 
processor. The database files must reside in your current directory. The 
processor makes no attempt to copy files from other directories. Entering 
END at this point will allow you to exit the processor. The program will 
attempt to open the database and allow you to reenter the information if an 
error occurs. 

ENTERING THE UNIVERSAL FILE NAME: 

The program will now prompt you to enter a name for the SUPERTAB 
Universal data file to be created. You may enter "filename.UNV" or just 
"filename" as the default subscript is ".UNV". You must enter the full name 
if you want a subscript other than ".UNV". Entering a carriage return will 
give you the default name of the database name with a file extension 
".UNV". 
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PROCESSOR LOG FILE: 

Many descriptive messages concerning the data in your Universal file may 
be generated during the execution of LOAD UNIVERSAL FILE. The 
processor will give you the opportunity to keep a log file of these messages. 
If you choose to create a log file, it will be given the same name as your 
Universal file but will end in ".LOG". 

ASSIGNING COLORS: 

FORMAT UNIVERSAL FILE: COLOR ASSIGNMENT MENU 

YOU MAY CHOOSE TO ASSIGN COLOR BASED ON ELEMENT PROPERTIES OR 
NODE NUMBER, OR ACCEPT THE DEFAULT COLOR ASSIGNMENTS: 
ELEMENTS/NODES - GREEN CONSTRAINTS - WHITE LOADS - BLUE 

1. ASSIGN COLORS TO ELEMENTS 

2. ASSIGN COLORS TO NODES 

3 . CONTINUE PROCESSING [DEFAULT] 

You may select the default color assignments as shown or choose a basis for 
element or node color assignments to emphasize some particular aspect 
such as material or physical properties. By choosing option 1 (ASSIGN 
COLORS TO ELEMENTS), you will not make specific color assignments (i.e, 
red, green, blue, etc.), but will choose the basis for color assignments that 
the program will automatically generate for you as presented in the 
ELEMENT COLOR MENU. 

FORMAT UNIVERSAL FILE: ELEMENT COLOR MENU 
CHOOSE ONE ELEMENT PROPERTY TO BE THE BASIS FOR COLOR ASSIGNMENT: 

1. PHYSICAL PROPERTY 

2. MATERIAL PROPERTY 

3. PERMANENT GROUP 

4. ELEMENT TYPE 

5. ELEMENT NUMBER RANGE 

6 . EXIT (USE DEFAULT ELEMENT COLOR) 


FINITE ELEMENT 


5-38 



FORMAT UNIVERSAL FILE 3 


By choosing option 2 (ASSIGN COLORS TO NODES) FROM THE COLOR 
ASSIGNMENT MENU, you will select the ranges of nodes which should be 
assigned different SUPERTAB colors: 

SUPERTAB COLORS WILL BE ASSIGNED SEQUENTIALLY BASED ON THE NODE 
NUMBER RANGES YOU ENTER. ENTER ONE NUMBER RANGE PER LINE (MAX 
20 RANGES). EX: 200 250 

RANGE 1: 


Enter up to 20 ranges (EX:51 100) followed by a final carriage return to 
return to the COLOR ASSIGNMENT MENU. When you have completed color 
assignments for elements and/or nodes, select option 3 (CONTINUE 
PROCESSING) from the COLOR ASSIGNMENT MENU. 

SELECTING DATA SET TYPES FROM THE DATA SET MENU: 

The program will now show you the DATA SET MENU: 


FORMAT UNIVERSAL FILE: DATA SET MENU 
ENTER DATA SET TYPES TO BE FORMATTED FROM RIM: 


OPTION 

(DATA SET TYPE) 

DESCRIPTION 

1 

05) 

NODE DATA 

2 

(55) 

DATA AT NODES 

3 

(71) 

CONNECTIVITY DATA 

4 

(731) 

PHYSICAL PROPERTY VALUE ENTRIES 

5 

(747) 

MATERIAL PROPERTY VALUE ENTRIES 

6 

(752) 

PERMANENT GROUP DATA 

7 

(755) 

RESTRAINT DATA 

8 

(756) 

LOAD SET DATA 

9 


ALL SUPPORTED DATA SET TYPES 

10 


BEGIN PROCESSING 


Enter option 9 if you would like to format all supported data set types from 
your database; otherwise choose the data set types you want one at a time, 
followed by option 10 to begin the processing. 
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SELECTING MODES: 

If you have chosen to format data set 55 (DATA AT NODES), you must now 
select which modes should be formatted from the eigenvector table 
(relation EIGNVECT in the IMAT database). 

FORMAT UNIVERSAL FILE: MODE NUMBER MENU 

WHICH MODES (CONDNUM) SHOULD BE FORMATTED FROM RELATION 
’’EIGNVECT'' FROM DATA SET 55 (DATA AT NODES) 

1. ALL MODE NUMBERS 

2. RANGE OF MODE NUMBERS 

Select option 1 (ALL MODE NUMBERS) to format all modes or option 2 
(RANGE OF MODE NUMBERS) to enter a specific range of modes desired. 
Processing time for a large number of modes may be significant. You will 
also be prompted to enter an optional RUN IDENTIFICATION (maximum of 
80 characters) for data set 55. 

PROCESSING THE DATA: 

The processor will now read through the Universal data file and format 
each data set type requested. It will inform you of each data set as it 
attempts to format it. If an error occurs during the processing (i.e., missing 
relation, unmatched element type, etc.), the program will inform you of the 
error but continue with the processing. 

EX: FORMATTING DATA SET 731 

!!! RELATION "BEAMPROP" WAS NOT FOUND 
UNABLE TO FORMAT BEAM PROPERTIES 


After formatting all requested data sets, the program will remind you of 
the log file name if you chose to generate one, and then return you to the 


IMAT EXECUTIVE. 
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PROCESSING ORDER: 

Element Property Value Entries (Data Set 731) must have been formatted 
in the Universal file in order to reference the properties in Data Set 71 
(Connectivity Data). Also, Permanent Group Data (Data Set 752) refers to 
element numbers which must have appeared previously in Data Set 71. 

The FORMAT UNIVERSAL FILE processor keeps track of which data sets 
have been loaded and will only format data for Data Sets 71 and 752 for 
which all element and property references have been formatted previously 
in the Universal file. 


COLOR TABLE: 

After the processing is completed, the log file will contain a listing of the 
color scheme for the Universal file. 
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Development of Dynamic Equations of Motion 


[m] p t Ic] p + [k] p = f 

where [m], |V] and [k] are the r x r masy damping and stiffness 
matrices, respectively, and p is an r-eiyhent vector of nodal 
displacements.^ The vector f contains Applied time‘depbndent 
forces that canfbe functions of p and/or p when contftfl forces are 
employed. 

In order to reducX the number olYdegrees of fAedom in the 
problem and decouple the equations of motion, the undamped 
natural modes of thV system ay used tty<fefine a generalized 
coordinate system, fhe natursfl modeyare calculated by ignoring 
[c] and f in equation (G) and/solvine/the resulting homogeneous 
equations for the first \mo<p shapds, ^ (r-element vectors), and 

frequencies, 


[m] p + [k] p = 0 


(3) 


Mode i is called a rigidAfody ntode if C 0 | = 0.0 and olhamise it is 

called a flexible modar The computer codes which perfofrn-4£is 
solution (IMAT uses^SC/NASTF^AN) may not return exact zeros 
for rigid body mody frequencies, \ut in practice these have been at 
least four ordeiVo/ magnitude smaller than the smallest flexible 
mode frequency; s/ are easily identifiable. Usually there will be 
six rigid body mofcies although there dan be fewer if rigid body 
degrees-oU#Teedarn have been construed during the solution 
process. visual w, each rigid body modX will incorporate 
components of /translation parallel to all\ three axes and components 
of relation abdlit all three axes. Provision is made for the user who 
would rather JUse "pure" rigid body modesXthan the modes given by 
MSC/NASTR^N in the linear systems modeX However, the rigid 
body modes/calculated by MSC/NASTRAN ifust be used in the 
linear systafns model if the IMAT physical data recovery 
procedure As to be used to obtain physical oufput. 

The mode shapes have a very useful property, called 
orthogonality, that is expressed in the equations 
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The partial differential equations governing the small motion of a 
linear, elastic structure can generally be put in the form: 


M 


d w(s,t) 

72 

at 


+ D 


3w(s,t) 

at 


+ L s [w(s,t)l = F(s,t) 


( 1 ) 


where the first two terms on the left side of the equation are the 
dynamic inertia and dissipative forces and the third term on the 
left is an elastic stiffness force described by a linear differential 
operator in spatial coordinates acting on the elastic deformation of 
the structure. These forces are balanced by the applied forces on 
the right side of the equation. 

In practice, means other than the integration of the partial 
differential equations governing the motion of a continuous 
complex structure are used to determine the dynamic behavior of 
the structure since the linear differential operator and spatial 
boundary conditions become unwieldy. The most common 
approach to the solution of a complex structure is to represent the 
structure by an assemblage of smaller structures such as rods, 
beams, and rectangular and triangular plates with known or 
assumed solutions. This procedure of discretizing the structure 
into smaller, simpler elements with known solutions is referred to 
as the finite element method. The behavior of the structure is now 
represented by the behavior of the nodes connecting the elements 
describing the structure and the governing equations have been 
reduced to a set of ordinary differential equations with a finite 
number of degrees-of-freedom, r, where r is the minimum 
number of measurements required to completely describe the 
motion of the nodes. 


The IMAT procedure for analyzing flexible space structures with 
active controls is based on the principle of modal superposition. 
The equations of motion for an r-degree-of-freedom structure are 
written as 
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[m] p + IcJ p + [k] p = f ( 2 ) 

where [m], [c] and [k] are the r x r mass, damping and stiffness 
matrices, respectively, and p is an r-element vector of nodal 
displacements. The vector f contains applied time-dependent 
forces that can be functions of p and/or p when control forces are 
employed. 


In order to reduce the number of degrees of freedom in the 
problem and decouple the equations of motion, the undamped 
natural modes of the system are used to define a generalized 
coordinate system. The natural modes are calculated by ignoring 
[c] and f in equation (2) and solving the resulting homogeneous 
equations for the first s mode shapes, <{>• (r-element vectors), and 
frequencies, coj (i = 1,2, ... ,s). 

[m] p + (k]p = 0 (3) 

Mode i is called a rigid body mode if coj = 0.0 and otherwise it is 

called a flexible mode. The computer codes which perform this 
solution (IMAT uses MSC/NASTRAN) may not return exact zeros 
for rigid body mode frequencies, but in practice these have been at 
least four orders of magnitude smaller than the smallest flexible 
mode frequency, so are easily identifiable. Usually there will be 
six rigid body modes although there can be fewer if rigid body 
degrees-of-freedom have been constrained during the solution 
process. Usually, each rigid body mode will incorporate 
components of translation parallel to all three axes and components 
of rotation about all three axes. Provision is made for the user who 
would rather use "pure" rigid body modes than the modes given by 
MSC/NASTRAN in the linear systems model. However, the rigid 
body modes calculated by MSC/NASTRAN must be used in the 
linear systems model if the IMAT physical data recovery 
procedure is to be used to obtain physical output. 

The mode shapes have a very useful property, called 
orthogonality, that is expressed in the equations 
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<t>^ [a] ^ = 0, i * j 
<t>^ [a] 0 * 0, i = j 


( 4 ) 


where [a] represents the mass matrix, [m], or the stiffness matrix, 
[k ] ; and the superscript T represents the transpose of the vector. 
For the present discussion it is assumed that [a] can also represent 
the damping matrix, [c], although this is not in general true. 
Equations (4) are used to normalize the mode shapes, 0j, before 

they are stored in an 1MAT database. The mode shapes are 
normalized such that 


<I>T [m] 0; = 1 (5) 

for all modes that are calculated (this is referred to as "normalizing 
the eigenvectors to the generalized masses"). 

The equations of motion (2) may now be decoupled to yield a set 
of single-degree-of-freedom equations if the forces, f, are not 
dependent on p and p. The decoupling is accomplished by a 
transformation of coordinates. First the generalized (modal) 
coordinates, q, are defined by the equation 

p = O q (6) 

where <t> is an r x s matrix defined as 

<D = [ ({Jj d 2 . . . 0 S J . 

Substituting equation (6) into equation (2) and premultiplying by 

T 

the transpose of the jth mode shape, 0., the generalized-coordinate 
(modal) form of the equations of motion are obtained as 
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4>J [m] <D q + ^[cJ^q + <>T [k] 4> q = (j>Jf (7) 

for j=l,...,s. 


If the terms on the left hand side of equation (7) are expanded, 
the orthogonality properties of the modes (equations (4)) will cause 
all of the terms to disappear except for the terms for mode j. 
Equation (7) then becomes a set of uncoupled equations: 

<t>^ [mj^q + <j)T [c]<t>jq + [k]<J>.q = (8) 

for j=l,...,s. 


Equation (8) is simplified by introducing the generalized coordinate 
(modal) mass, damping, stiffness and force as follows: 


M. = <J> T [m] 6. = 1 
J J J 

(9) 

• — > 
O 

II 

lP 

(10) 

77 

H 

(11) 

1 » 
\\ 

(12) 

It can be shown that the generalized stiffness and 
are related by the equation 

generalized mass 

K. = to 2 M. = to 2 
J J J J 

(13) 

Using equations (9) through (13), equation (8) can 
generalized coordinate (modal) form as 

be rewritten in 

q. + 2^. co. q. + co 2 q. = f„ j = 1, 2, ... , s 
J J J J J J j 

(14) 


! 
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where is the modal damping ratio defined as 

C. = C./2co. 

J J J 


( 15 ) 


In matrix notation, equation (14) can be written as 

q + [ 2 ^ 0 ) ] q + [ co 2 ] q = <D T f (16) 

where [ 2£co J and [ co 2 ] represent s x s diagonal matrices composed 
of elements 2£.co. and ox, respectively. In IMAT, the first order 
state space form of equation (16) is obtained by defining the state 

y y 

space vector x as x = [ q , q ] . Then the first order state space 
form can be written as 



0 I 

! x + 

ro l 

X = 

-[to 2 ] -[2Cco]_ 


L. 


07) 


Usually, some of the forces fare control forces that are functions of* 
p and/or p and are therefore functions of q and q. The modal 
equations (14) are therefore coupled through the forcing function 
on the right hand side and cannot be solved independently. In the 

IMAT process the finite element code MSC/NASTRAN is used to 
calculate the mode shapes and frequencies. The state space form 
of the coupled equations of motion are solved by a controls code 
such as MATRIXx. 

In the preceding discussion, it was assumed that equations (4), the 
orthogonality conditions, could be used to decouple the damping 
terms in the equations of motion. This decoupling can actually be 
achieved only if certain conditions are met. These special cases are 
listed below: 

1. The damping matrix [c] is a linear combination of the mass 
and stiffness matrices (Rayleigh damping), and therefore 
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equation (15) can be used to calculate the damping 
coefficients, £. 


2. The damping terms in [c] are small, and the non-zero 
off-diagonal terms in the matrix that results from the 

product <J>. [c]<D in equation (7) can be neglected. Equation 

(15) is then used to calculate the damping coefficients, £. 

3. The structure is lightly damped, and the generalized (modal) 
damping coefficients, £, are known for each mode retained in 
the analysis. In this case the generalized (modal) damping 
matrix is obtained by direct substitution of known values of 

the modal damping coefficients. The product <|> T [c] O in v 

equation (7) is ignored, and equation (15) is not used. 


The * MAT P rocess Proceeds under the assumptions that damping 
coefficients are known for each mode used in the analysis, and that 
there are no significant cross-coupling terms in the modal damping 
matrix. In actual practice the values of the modal damping 
coefficients may not be known, and suitable values must be 
assumed As unscientific as this may seem, the reader should be 
aware of the fact that off-diagonal terms of the original [c] matrix 
are generally not known and are very difficult, if not impossible, to 
obtain by test in the laboratory for complex structures. 


CONTROLS 


6-6 


Generation of Linear Systems Matrices 1 


Linear systems theory deals with systems which have the form 

x = Ax + 6u + fef (18) 

y = tx + Du (19) 

where A, 6, t, D, and are constant matrices; and x, u, f, and y are 
vector functions of time. Elements of x are the states of the 

system. Elements of u and f are controls and forcing functions of 
the system, respectively. Elements of y are the outputs or sensor 
readings. 

We deal here with linear systems which model the dynamics of a 
flexible structure. The states are chosen from the rigid body 
motions and modal amplitudes and their rates with some 
restrictions. A rigid body motion or modal amplitude appears if 
and only if its rate also appears. Rigid body motion can be 
incorporated in the model either by using some or all of the six 
rigid body degrees-of-freedom obtained from Newtonian dynamics 
or by using some or all of the modal amplitudes corresponding to 
the zero frequency modes obtained from the finite element 
analysis, but not a mixture of these. However, the rigid body 
modes calculated by MSC/NASTRAN must be used in the linear 
systems model if the IMAT physical data recovery procedure is to 
be used to obtain physical output. We are dealing with the result 
of finite element modeling, so the dynamics of the structure are 
represented as the motions of a finite collection of points called 
nodes and represented in a coordinate system fixed to the 
structure. Inputs are restricted to be forces and/or torques 
applied at nodes. Outputs are restricted to be translations parallel 
to an axis or rotations about an axis at the nodes or the time 
derivatives thereof. The underlying equations on which the linear 
systems equations are based are given in equations (20) through 
(24) for modal amplitude and Newtonian rigid body motions. 

IMAT's GENERATE LINEAR SYSTEMS MATRICES (GLSM) processor 
assumes that rigid body and flexible motion of the structure are 
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governed by the equations: 


M Pr = X F n 
n 


(20) 

1 0, = X < T „ + L „ F „> 

n 


(21) 

+ ^m W !n + ®tn 

= y (<D F + O 1 T ) 

Lu v mnc nc mnc nc' 

n,c 

(22) 

Pnc — ! ^mnc 

m 


(23) 

e = y O’ q 

nc t—d mnc M m 

• 

• 

(24) 


m 


where 


c 



I 

L 


n 


m 

M 

n 


Pr 


Pn 


a subscript which varies in the set {x, y, z } (so, e.g., p. 
could be p x , p y , or p z ). 


the vector (F , F , F V. 

v nx’ ny’ nz y 

the force applied at node n in the direction parallel to 

the c-axis, c = x, y, or z. 

mass moment of inertia matrix. 

lever arm matrix of node n with respect to the center of 


mass. 

a subscript which indexes the structural modes, 
mass matrix. 

a subscript which indexes the nodes of the structure, 
the vector (p fx , p ry , p rz ) T = (x r , y r , z f ) T , the rigid body 
position. 

the vector (p nx , p ny , p nz ) T = (x n , y n , z n ) T , the position 
of node n. 
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q m modal amplitude of mode m. 

T n the vector (T„ x , T„ y , T nz ) T . 

T nc the torque applied at node n around the c-axis, c = x, y, 


9r 

<ln 


or z. 

damping ratio of mode m. 

T 

the vector (0,0,0) = 

v rx’ ry’ rz y 

attitude. 


(<t> r v <V P r ) T ’ the rigid body 

the vector 


(0 ,0 ,0 ) T = (<b , a , B ) T , the attitude of 

v nx’ ny’ nz' vv n’ n’ K n ; 


node n. 


I. LL 

m n n,c ’ 


etc. 


summation over all modes, over all nodes, over all 
nodes and coordinates, etc. 

d> mode shape component of mode m at node n in 
mnc 


coordinate c. 

4> mnc mode slope component of mode m at node n in 
coordinate c. 

w m frequency of mode m. 


Equation (20) describes rigid body translation; (21), rigid body 
attitude; (22), modal amplitude; (23), nodal position; and (24), 
nodal attitude. 


Of the terms in these equations, the values for M, I, L n , w m , ^mnc’ 

and ^mnc, and the ranges of the indices m and n are derived from 
information extracted from the IMAT formatted data base; z m , F n 
and T n are supplied by the user; and p r , q r , q m , p nc , and q nc are 
defined by equations (20)-(24) together with initial conditions on 
p r , q r , q m and their rates. 

As a result of these considerations, the linear system takes on a 
special form. We take advantage of this form to compress the 
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linear systems matrices information. First, we may take 
T T T 

x = [ q , q ] where q contains the user’s selection of Newtonian 
rigid body modes and/or modal amplitudes and q contains the 
corresponding velocities. We observe that an output which is a 
translation or rotation is calculated from just the q part of the state 
by a calculation of the form cq (vector dot product) and that the 
associated rate is c q. Finally, for the convenience of the controls 
engineer, we divide the system inputs into two classes, one 
containing actuators which are the inputs over which the engineer 
has control and the other containing external forces and torques 
which are influences acting on the structure which are beyond the 
engineer’s control. We denote the actuator inputs by u, the 
external force/torque inputs by f, and restrict y to denote position 
sensors so that rate and acceleration sensors become y and y. Then 
equation (17) can be written as 


q 


0 

I 

' q' 


o ' 


0 

q_ 


-[CO 2 ] 

-[2Cco] 


+ 

4> T B c 

U + 

<b T B f 


(25) 


where 0 is a null matrix and I is an identity matrix; B c and Bf are 

a control influence matrix and a disturbance influence matrix, 
respectively. The linear system equations then take the form’ of 
equations (18) and (19); 


q 

q 


0 I 

d »ag(A 2l ) diag(A 22 ) 



" q " 


' o ' 


' o ' 



+ 


u + 



. q . 


. B. 


. E. 


f 


(26) 


y = 


C 0 ] 


q 

q 


+ D u 


where 






(27) 


(28) 
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A 22 = [ • 2 ^1 0) 1 ■ 2 ^2 Q) 2 • • * J T 

(29) 

B = <D T B c 

(30) 

E = <t> T B f 

(31) 


Assuming D is a null matrix, velocity and acceleration sensor 
readings can be obtained by 

y = Cq ( 32 > 

y = Cq ( 33 > 

By substituting the q term from equation (26) into the equation 
(33), we obtain 

y = C diag(A 2] ) q + C diag(A 22 ) q + CBu + CEf (34) 

Equation (33) does not fit into the generic linear systems form 
since q is not part of our system states; but in any application 
where equation (26) is being solved, q may well be available and 
equation (34) would be the efficient way to compute the 
acceleration sensor readings. By comparing equations (18) and 
(19) with equations (26) and (27), full linear systems matrices can 
be defined as follows: 


0 I 

diag(A 21 ) diag(A 22 ) 


§ = 
t = 


0 ' 

B. 

[CO] 


(35) 

(36) 

(37) 



(38) 
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In the above example matrix & was defined to get physical 
displacement output at the sensor locations. The user can also 

define the £ matrix to get velocities and accelerations using 
equations (32) and (33). Modal displacements, velocities, and 

accelerations can also be obtained by changing the £ matrix. 

Instead of passing full linear systems matrices to the GLSM data 
file, the GLSM processor passes the matrix A which contains only 
the vectors A 2 J and A 22 in its first two columns, i.e. 


A 


[ A., A„ ] 
1 21 22 J 


(39) 


and the matrices B, C, and E. The matrices A and B are generated 
for most feedback control problems, but the generation of matrices 
C and E depends on whether the system has sensors and external 
forces. A quantity of supplemental information describing the 
modes, actuators, sensors, etc., being modeled is also made available 
in the list file generated by GLSM. 

The compressed linear systems matrices (A, B, C, and E) stored in 
the GLSM data file are formatted so that the file is readily readable 
by MATRIXx. At this point, the user can easily recover the full 
linear systems matrices required for MATRIXx simulation from the 
compressed GLSM matrices by employing the MATRIXx commands. 

For instance, assume that the user generated a GLSM data file 
named GLSM.DAT which contains A, B, and C matrices. Then the 
following sequence of MATRIXx commands can be used to recover 

the full matrices (A, 6, and £} required by MATRIXx. 
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LOAD GLSM.DAT 

[N,NB]=SIZE(B); 

[NC,N]=SIZE(C); 

ZA=0*ONES(N); 

IA=EYE(N); 

ZB=0*ONES(N,NB); 

AA=[ZA,IA;DIAG(A( 

BB=[ZB;B]; 

CC=C*[IA,ZA]; 

DD=C*ZB\ 

S=[AA,BB;CC,DD]; 

NS=N*2; 

SAVE GLSM.SNS S 


| Read GLSM.DAT into MATRIXx] 

[Find the matrix size of B and C 
Matrices] 

[Define an N x N null matrix] 

[Define an N x N identity matrix] 
[Define an N x NB null matrix] 
:,1)),DIAG(A(:,2))]; 

[Recover A matrix] 

[Recover 6 matrix] 

[Recover £ matrix] 

[Recover D matrix] 

[Define a MATRIXx system matrix] 
[Define the size of state variables] 

NS [Save the system matrix and its size in 
a file named GLSM.SNS] 


MATRIXx always requires a D matrix. The user should define a 
null matrix of appropriate size if the system does not have a D 
matrix. 
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PROCESSOR: DEFINE CONTROL SYSTEM 

PURPOSE: The DEFINE CONTROL SYSTEM processor facilitates the 

definition and/or modification of a control system. 

ENTERING THE NAME OF THE DATABASE: 

You will be asked to enter the name of the database to be used for 
controls analysis and its corresponding password. The database 
must reside in your current directory. The processor makes no 
attempt to copy databases from other directories. 

CHOOSING A RELATION: 

The first menu displayed is the EDIT SELECTION MENU: 

DEFINE CONTROL SYSTEM: EDIT SELECTION MENU 

1. DESCRIPTION OF ACTUATOR 

2. DESCRIPTION OF SENSOR 

3 . DESCRIPTION OF EXTERNAL FORCE/TORQUE 

4 . COMPLETE DESCRIPTION OF SYSTEM 

5 . MODAL FREQUENCIES AND DAMPING RATIOS 

6 . RETURN TO THE IMAT EXECUTIVE 

Selections 1 through 5 correspond to the database relations 
ACTUATOR, SENSOR, EXTFTAP, SYSTEM, and EIGNVALS, respectively. 
The processor is designed to permit you to choose control system 
components, add and/or modify data using the subsequent menus, 
and return to this menu to select the next component. Option 6 
causes you to exit the processor and return to the IMAT EXECUTIVE 
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SELECTING THE APPROPRIATE OPERATIONS: 

The OPTIONS MENU provides the operations necessary to manipulate 
the control system data. 


DEFINE CONTROL SYSTEM: OPTIONS MENU 
Current Component 

1. ADD 

2. DELETE 

3. MODIFY 

4. REVIEWDATA 

5. LIST DATA DESCRIPTION 

6. OUTPUT DATA TO A FILE 

7 . OUTPUT DATA DESCRIPTION TO A FILE 

8. PREVIOUS MENU [DEFAULT] 

This menu serves as a basis for the system definition procedure. The 
various options are discussed on the following pages. Current 
Component refers to the control system that was chosen from the 
EDIT SELECTION MENU. 

ADDING DATA TO THE DATABASE: 

After choosing the ADD option from the OPTIONS MENU, you will be 
prompted to enter rows of data, one at a time. The first value in 
each component row serves as a unique identifier for the information 
in that row. You have the choice of automatic row identification 
generation or entering identification numbers for each row manually. 
If you choose automatic generation, the processor will create 
identification numbers of consecutive integers, beginning with 1. 
Otherwise, you have the opportunity to enter row numbers 
beginning with any positive integer that you desire. Next you will be 
prompted to enter appropriate data for each subsequent component 
in the system. You will then be asked if it is all right to load the 
information into the database. If you have made an error or choose 
not to load the information, you may enter it again when you are 
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asked to enter the next row of data. When you have finished 
entering information, the program will return to the OPTIONS MENU 

DELETING DATA FROM THE DATABASE: 

The DELETE option exhibits the following menu: 

DEFINE CONTROL SYSTEM: DELETE MENU 
Current Component 

1 . DELETE BY component row ID NUMBER 

2. DELETE BY RANGE OF component row ID NUMBERS 

3. PREVIOUS MENU [DEFAULT] 

Option 1 allows you to enter the identification number of one 
component row that you would like to delete. Option 2 asks you to 
enter a range of identification numbers corresponding to the 
components that you want to delete. You have the opportunity to 
review the data in each of the selected rows before they are deleted. 
You are asked to confirm the deletion of each row from the database. 
After completing either selection, you are returned to the DELETE 

uS ng ° Pti ° n 3 wiU cause the P r °g ram to return to the 
Or 1 IONS MENU. 

MODIFYING DATA IN THE DATABASE 

The first menu shown when you choose the MODIFY option is: 

DEFINE CONTROL SYSTEM: MODIFY MENU 
Current Component 

1 . DUPLICATE AN EXISTING component 

2. MODIFY BY component ID NUMBER 

3. PREVIOUS MENU [DEFAULT] 

If you choose to duplicate an existing component row, (option 1) all 
of the data from the original row is copied into the duplicated row 
except for the row identification number. You are asked to choose 
the new identifier number with the default value being the next 
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consecutive integer higher than the last component row identification 
number. 

Option 2 provides the menu: 

DEFINE CONTROL SYSTEM: MODIFY BY component ID NUMBER 
Current Component 

1 . MODIFY EACH ITEM IN AN EXISTING component 

2. MODIFY ONE ITEM IN AN EXISTING component 

3. PREVIOUS MENU [DEFAULT] 

Modifying each item in a component row involves re-entering each 
item of data in the row. Option 2 allows you to modify only one item 
in a data row. You are asked to enter the name of the value that you 
want to modify. If you do not know the names of the values, enter 
LIST at the prompt and a description of the component row will be 
provided. Option 3 returns to the MODIFY MENU. At this point you 
may enter a carriage return to view the OPTIONS MENU again. 

REVIEWING DATA: 

To review data of the current component, select options from the 
menu: 


DEFINE CONTROL SYSTEM: REVIEW MENU 
Current Component 

1. BRIEF REVIEW 

2. REVIEW ONE component row 

* 3. REVIEW BY RANGE OF component row ID NUMBERS 

4. REVIEW ALL DATA 

5. PREVIOUS MENU [DEFAULT] 

The BRIEF REVIEW option displays each component row number and 
its corresponding row description. To review one component row, 
enter the appropriate identification number and the data in that row 
will be displayed. Enter the corresponding row identification 
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numbers to review a range of data rows. Option 4 displays all of the 
current component data. Option 5, returns to the OPTIONS MENU. 

LISTING DATA DESCRIPTIONS: 

The LIST DATA DESCRIPTIONS, option (5) of the OPTIONS MENU, lists 
the descriptions of the current component. 

CREATING A PRINT FILE: 

Options 6 and 7 of the OPTIONS MENU output the data of the current 
component and the component description respectively. You may 
choose the type of data to be written to the file from the following 
menu: 

DEFINE CONTROL SYSTEM: PRINT DATA MENU 
Current Component 

1 . PRINT DATA SUMMARY 

2. PRINT DATA 

3. PREVIOUS MENU {DEFAULT] 

Option 1 prints each row of data and its corresponding description to 
the print file. Option 2 writes all of the current component data to 
the file. Option 3 returns to the previous menu. 
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PROCESSOR: GENERATE LINEAR SYSTEMS MATRICES 

PURPOSE: The GENERATE LINEAR SYSTEMS MATRICES processor 

creates a data file of linear systems matrices for input into the 
EXECUTE MATRIXX processor. 

ENTERING THE NAME OF THE DATABASE AND THE NAME OF THE 
EIGENVECTOR FILE: 

You are asked to enter the name of the database which contains your 
linear systems information, and the corresponding password for this 
database. The processor will also ask you to enter the name of the 
eigenvector file that is associated with the database (see the finite 
element processor LOAD ANALYSIS RESULTS ). If the database 
and/or the eigenvector file are not in your current directory, you are 
asked to enter the directory where they reside. The processor will 
make copies of these files in your current working directory, 
although they will be deleted upon completion of the processor. 

ENTERING A NAME FOR THE MATRIXx DATA FILE: 

You are asked to enter a name for the MATRIXx data file that will be 
created. When prompted to enter a file name, you may choose the 
default name, GLSMMAX.DAT, by entering a carriage return. 

ENTERING A NAME FOR THE LIST FILE 

You are asked to enter a name for the list file which will contain the 
linear matrices data in a specified format. When prompted to enter a 
file name, you may choose the default name, GLSM.PRN, by entering 
a carriage return. 

GENERATING THE MATRIXx DATA FILE: 

This processor creates linear systems matrices according to the 
specifications described in the database. You are asked to enter the 
system identification number that corresponds to the entry in 
relation SYSTEM that will be used to define these matrices. If the 
data required for each set exists, the processor will generate matrices 
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A, B, C, and E respectively. Otherwise error messages will be 
displayed to indicate inconsistencies in your system definition. 
Although matrices C and E are not required for a valid linear system, 
there must be sufficient data in the database to generate the A and B 
matrices. Upon completion of each matrix the following messages will 
appear: 

GENERATING LINEAR SYSTEMS MATRICES 

A MATRIX... 

B MATRIX... 

C MATRIX... { data permitting } 

E MATRIX... { data permitting } 


EXITING GENERATE LINEAR SYSTEMS MATRICES: 

After the data file is generated, the processor will return to the 
IMAT EXECUTIVE. 
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PROCESSOR: EXECUTE MATRIXX 

PURPOSE: The EXECUTE MATRIXX processor executes Integrated 

Systems' MATRIXx/SYSTEM_BUILD giving you a choice of memory 
size. You should be familiar with MATRIXx commands in order to 
execute this processor. 

MAIN MENU OPTIONS: 

MATRIXx uses a stack to store variables and temporary results in 
calculations. The different stack sizes available for MATRIXx at your 
installation reflect the central memory that will be available for your 
execution. (The following menu may be different at your installation): 

EXECUTE MATRIXX: STACK SIZE MENU 

ENTER THE STACK SIZE DESIRED FOR THIS EXECUTION OF MATRIXX OR "Q" TO 
QUIT: 

1 . 100,000 ELEMENT STACK [DEFAULT] 

2. 250,000 ELEMENT STACK 

3. 350,000 ELEMENT STACK 

4. 450,000 ELEMENT STACK 

5. 1,000,000 ELEMENT STACK 

Upon completion of MATRIXx, you will be returned to this menu. Enter a Q to 
return to the IMAT EXECUTIVE. If MATRIXx issues an error indicating that 
you need more memory for a particular problem, choose a larger stack size 
for your execution. 
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PROCESSOR: RECORD CONTROL SIMULATION 

PURPOSE: The RECORD CONTROL SIMULATION processor is designed to 

enter into the IMAT database all of the information required by the 
RECOVER PHYSICAL OUTPUT processor when generating an 
MSC/NASTRAN modified Solution 31 bulk data deck to obtain physical 
output such as displacements or stresses from a state space simulation. 

SELECTING A DATABASE: 

You will be asked to enter enter the name of the database to be used with 
this processor. Because this program writes to the database, your 
database files must reside in your current default directory. If they do 
not, you will need to exit IMAT and reset your default directory. 

MAIN MENU OPTIONS: 

After the program has successfully opened your database, you will see 
the MAIN MENU which offers options to let you enter or change a record 
of a controls simulation. To exit the program at any time, enter Q at this 
or any menu: 


RECORD CONTROL SIMULATION: MAIN MENU 

CHOOSE THE FUNCTION DESIRED OR Q TO QUIT: 

1 . ENTER RECORD OF NEW SIMULATION INTO DATABASE [DEFAULT] 
2 CHANGE/REVIEW EXISTING SIMULATION RECORD IN DATABASE 
3 . DELETE SIMULATION RECORD 
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MAIN MENU OPTION 1: ENTER RECORD OF NEW SIMULATION 
INTO DATABASE 


Option 1 will prompt you for all of the information required to enter a 
full record of a controls analysis simulation into your database. The 
program automatically generates a new simulation number and then 
prompts you for: 

1. Analyst's name: Enter the name of the controls analyst (40 

char, max) 

2. Analysis date: Enter the date of the analysis in the format 

01 -FEB-1988 [default = today] 

3. ID of the control system used in the simulation: 

You will select this from the SYSTEM MENU which presents all of the 
systems documented in your database: 

RECORD CONTROL SIMULATION: SYSTEM MENU 

SELECT THE SYSTEM USED IN THIS SIMULATION: 



SYSTEM ID 

DESCRIPTION 


1 . 

1 

This is your description of 

system # 1. 

2. 

3. 

2 

This is your description of 

system # 2. 

Selection 

of a system 

will determine the structure of 

the information 


you enter about your simulation. You will be prompted for time 
history files to match the system you select for this simulation. 

4. Simulation description: An optional description of your 

simulation (80 char, max) 
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5. Simulation time in seconds: 

Initial time: A real value [default=0.0] 

Final time: A real value 

Time step interval: A real value 

6. The names of the 3 modal output files: 

Modal displacement file: (max 40 char.) 

Modal velocity file: (max 40 char.) 

Modal acceleration file: (max 40 char.) 

Enter the file names only. Do not include any directory 
specification: EX: MYFILE.DAT 


7. Information concerning the time history file for every control 
force/torque and applied load in your control system: 

Time history file name: Give the file name only - include no 

directory specification (40 char max). 
Start time. A real value [default = 0.0J 

End time: A real value 

Uniform time step: A real value 


At this point, the record of your simulation is complete, and the RECORD 
CONTROL SIMULATION processor will return you to the MAIN MENU. 


MAIN MENU OPTION 2: CHANGE/REVIEW EXISTING 
SIMULATION RECORD IN DATABASE 

Option 2 will allow you to inspect the record of a controls simulation and 
make any corrections required. Use this option only for corrections or 
inspection, not to enter a record of a new simulation ( See MAIN MENU 

OPTION 1). Under this option you will first choose a simulation to change 
from the SIMULATIONS MENU: 
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RECORD CONTROL SIMULATION: SIMULATIONS MENU 

SELECT THE SIMULATION RECORD YOU WANT TO CHANGE: 

STMIJL. ID SYSTEM ID DESCRIPTION 

1 1 1 Your description of simulation #1 

9 2 1 Your description of simulation #2 

3. 

The RECORD CONTROL SIMULATION processor will now display the 
CHANGE MENU so that you can quickly access the part of the record you 
want to change: 


RECORD CONTROL SIMULATION: CHANGE MENU 

WHAT PART OF THIS SIMULATION RECORD DO YOU WANT TO CHANGE: 


1 . SIMULATION DESCRIPTION INFORMATION 

2 . CONTROL FORCE/TORQUE TIME HISTORY FILES 

3 . APPLIED LOAD TIME HISTORY FILES 

4. RETURN TO "SIMULATIONS MENU" [DEFAULT] 


CHANGE MENU OPTION 1 : SIMULATION DESCRIPTION INFORMATION 

This option will allow you to inspect or change the general description of 
your simulation (i.e., analyst, date, description, simulation times, and 
modal output file names). You will first see the SIMULATION 
DESCRIPTION MENU: 
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RECORD CONTROL SIMULATION: SIMULATION DESCRIPTION MENU 
CHOOSE THE DATA ITEM YOU WANT TO CHANGE: 



DATA ITEM 

CURRENT VALUE 

1 . 

DESCRIPTION: 

Your description of 
simulation 

2. 

SIMULATION DATE: 

01 -FEB-1 988 

3. 

ANALYST: 

JOHN DOE 

4. 

INITIAL TIME (SECONDS): 

0.0 

5. 

FINAL TIME ( " ) : 

200.0 

6. 

TIME STEP ( ’’ ) : 

.5 

7. 

MODAL DISPLACEMENT FILE: 

RQUE.DAT 

8. 

MODAL VELOCITY RLE: 

RVEL.DAT 

9. 

MODAL ACCELERATION RLE: 

RACC.DAT 

10. 

NO CHANGES - RETURN TO "CHANGE MENU" [DEFAULT] 


Choose options 1-9 to make changes to the general description 
information you have previously entered about this simulation. You will 
then be prompted for a new value for the item. You may not change 
either the simulation ID, which is generated automatically for you or the 
control system ID. The time history files entered for this simulation must 
match the actuators and external forces defined for a system. 
Consequently, changing the system ID might invalidate this record. If the 
system ID is incorrect, first delete this record (OPTION 3 from the MAIN 
MENU) and enter a new record (OPTION 1 from the MAIN MENU). 

Select menu item 10 (NO CHANGES) or menu item 11 (SAVE CHANGES TO 
THE DATABASE - This appears after you have made changes) to return to 
the CHANGE MENU after you have made all changes desired. 


CHANGE MENU OPTION 2: CONTROL FORCE/TORQUE TIME HISTORY FILES 

This option will allow you to inspect or change information about the 
control force/torque time history files including the file name, start and 
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end times, and the time step interval. You will first see the CONTROL 
FORCE/TORQUE MENU: 

RECORD CONTROL SIMULATION: CONTROL FORCE/TORQUE MENU 
SELECT THE RECORD YOU WANT TO REVIEW/CHANGE: 

ACTUATOR ID TIME HISTORY FILE 

1. 1 ACC1.DAT 

2. 2 ACC2.DAT 

3 . RETURN TO "CHANGE MENU " [DEFAULT] 

Make one selection at a time from this list of all the control force/torque 
time history files recorded for this simulation. You will then be allowed 
to inspect and/or change the data regarding this file: 

RECORD CONTROL SIMULATION: TIME HISTORY CHANGE/REVIEW 
MENU 

CHOOSE THE DATA ITEM YOU WANT TO CHANGE: 


DATA ITEM 


CURRENT VALUE 


1. TIME HISTORY FILE: ACC1.DAT 

2. START TIME (SECONDS): 0.000 

3. END TIME ( " ): 10.000 

4. TIME STEP ( " ): 0.100 

5. NO CHANGES [DEFAULT] 


Choose options 1-4 to make changes to the information about the control 
force/torque time history files that you previously entered. You will then 
be prompted to supply a new value for the item. You may not change the 
actuator ID which was previously defined for this control system. Select 
option 5 (NO CHANGES) or option 6 (SAVE CHANGES TO DATABASE - this 
appears once you have made changes) when you have completed all 
changes concerning this time history file. 
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CHANGE MENU OPTION 3: APPLIED LOAD TIME HISTORY FILES 

I his option will allow you to change information about your applied load 
time history files. See CHANGE MENU OPTION 2 for a detailed description 
of the menus involved. 

CHANGE MENU OPTION 4: RETURN TO "SIMULATIONS MENU" 

Select this option when you have completed all changes to this simulation 
You may return to the MAIN MENU by selecting the last option on the 
SIMULATIONS MENU. 

MAIN MENU OPTION 3: DELETE SIMULATION RECORD 

This option will delete the record of a controls simulation from your 
database. It will not delete any of your system, actuator, or loads 
information or any structural model information. Use this option if you 
have entered a simulation record in error and want to replace it with a 
new record. 
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PROCESSOR: QUERY EIGENVECTOR FILE 

PURPOSE: To display eigenvector data for a specific node number 

and mode number. This data is stored in the eigenvector file created 
by the LOAD ANALYSIS RESULTS processor (MSC/NASTRAN menu, 
option 4). 

ENTERING THE NAME OF THE EIGENVECTOR FILE: 

You will be asked to enter the name of the eigenvector file that you 
want to interrogate. If this file is not in your current directory the 
processor will ask you to enter the full pathname to the directory 
where the file is located. The processor will copy the file into your 
current directory; however it will be deleted upon completion. 

DISPLAYING EIGENVECTOR DATA: 


This processor displays information based on node and mode 
numbers for a given eigenvector. You are asked to enter the node 
number and the corresponding mode number (attribute CONDNUM) 
of the data you want to examine. If data exists in the file coinciding 
with the values that you entered, the data will be exhibited in the 
following format: 


NODENUM X-EIGEN 
xxxxxxx xxxxxxx 

X-ROTN Y-ROTN 

xxxxxx xxxxxx 


Y-EIGEN Z-EIGEN 
xxxxxxx xxxxxxx 


Z-ROTN CONDNUM 
xxxxxx xxxxxx 


If an entry can not be found matching the given node and mode 
numbers, the processor will display: 

!!! EIGENVECTOR DATA NOT FOUND WITH 

NODENUM: xxxxxx 
CONDNUM: xxxxxx 
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EXITING THE PROCESSOR: 

You will be asked if you would like to locate more eigenvector data. 
If not, the processor will return to the IMAT EXECUTIVE. 
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Relation Overview 1 


ACTUATOR 

ACTUATOR DESCRIPTION 

ORIGIN: DEFINE CONTROL SYSTEM 

DESTINATION: GENERATE LINEAR SYSTEMS MATRICES 


BEAMPROP 

GENERAL BEAM PROPERTY 
ORIGIN: 

DESTINATION: 

BEAMREF 

BEAM ORIENTATION 

ORIGIN: 

DESTINATION: 

BEAMS 

TWO NODE ELEMENT 
ORIGIN: 

DESTINATION: 

CONMASS 

CONCENTRATED MASS 
ORIGIN: 

DESTINATION: 

CONSTRN 

NODAL CONSTRAINTS 
ORIGIN: 

DESTINATION: 


SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN. SUPERTAB 


DBDESC 

DATABASE DESCRIPTION 

ORIGIN: CREATE DATABASE, DEFINE CONTROL SYSTEM 

DESTINATION: USER'S INFORMATION 


DYNFORCE 

DYNAMIC FORCE DESCRIPTION 

ORIGIN: RECORD CONTROL SIMULATION 

DESTINATION: RECOVER PHYSICAL OUTPUT 


EIGNVALS 

NATURAL FREQUENCIES 

ORIGIN: MSC/NASTRAN, DEFINE CONTROL SYSTEM 

DESTINATION: GENERATE LINEAR SYSTEMS MATRICES, SUPERTAB 

EIGNVECT 
EIGENVECTOR DATA 

ORIGIN: MSC/NASTRAN 

DESTINATION: GENERATE LINEAR SYSTEMS MATRICES, SUPERTAB 
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ELEMLOAD 

ELEMENT PRESSURE LOADS 

ORIGIN' SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


ELEM-MAP 
A SCRATCH RELATION 

ORIGIN: CREATE DATABASE 

DESTINATION: FORMAT BULK DATA, LOAD BULK DATA 

EVECINFO 

INFORMATION ABOUT EIGENVECTOR FILE 

ORIGIN' DEFINE CONTROL SYSTEM, LOAD ANALYSIS RESULTS 

DESTINATION: GENERATE LINEAR SYSTEMS MATRICES 


EXTFTAP 

EXTERNAL FORCE/TORQUE APPLICATION POINT DEFINITION 
ORIGIN: DEFINE CONTROL SYSTEM 

DESTINATION: GENERATE LINEAR SYSTEMS MATRICES 


MAT-PROP 
MATERIAL PROPERTIES 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN. SUPERTAB 


MODELDEF 

DIRECTORY OF GROUPS 

ORIGIN: SUPERTAB 

DESTINATION: USER'S INFORMATION, SUPERTAB 


NODELOAD 

NODAL TEMPERATURES AND LOADS 

ORIGIN: SUPERTAB. MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


NODES 

NODE NUMBERS AND COORDINATES 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 

QUADS 

FOUR-NODE ELEMENT 

ORIGIN: SUPERTAB, MSC/NASTRAN, 

DESTINATION: MSC/NASTRAN, SUPERTAB 


RIGIDBAR 

MSC/NASTRAN RIGID ELEMENTS (RBARS) 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 
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RIGPROP 

RIGID-BODY MASS PROPERTIES 

ORIGIN: MSC/NASTRAN 

DESTINATION: GENERATE LINEAR SYSTEMS MATRICES 

SCRREL 

A SCRATCH RELATION 
ORIGIN: 

DESTINATION: 

SENSOR 

SENSOR DEFINITION 
ORIGIN: 

DESTINATION: 

SIMULATE 
SIMULATION INFORMATION 

ORIGIN: RECORD CONTROL SIMULATION 

DESTINATION: RECOVER PHYSICAL OUTPUT 

STRNENG 

STRAIN ENERGY AND STRAIN ENERGY DENSITY FOR EACH ELEMENT 
ORIGIN: MSC/NASTRAN 

DESTINATION: USER'S INFORMATION 


DEFINE CONTROL SYSTEM 
GENERATE LINEAR SYSTEMS MATRICES 


FORMAT BULK DATA, LOAD BULK DATA 
MSC/NASTRAN 


SYSTEM 

LINEAR SYSTEM DEFINITION 

ORIGIN: DEFINE CONTROL SYSTEM 

DESTINATION: GENERATE LINEAR SYSTEMS MATRICES 


TRIANGLS 

THREE-NODE ELEMENT 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 
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ABSORP 
ABSORPTIVITY 
RELATIONS USED IN: 
ORIGIN 
DESTINATION 


TYPE = REAL 
MAT-PROP 

SUPERTAB, MSC/NASTRAN 
CURRENTLY UNUSED 


UNITS 


ACCELFILE TYPE = TEXT 40 UNITS 

NAME OF RLE CONTAINING MODAL ACCELERATIONS 
RELATIONS USED IN: SIMULATE 

ORIGIN: RECORD CONTROL SIMULATION 

DESTINATION: RECOVER PHYSICAL OUTPUT 


ACDOC TYPE= TEXT 80 UNITS 

DESCRIPTION OF ACTUATOR 

RELATIONS USED IN: ACTUATOR 

ORIGIN: DEFINE CONTROL SYSTEM 

DESTINATION: USER'S INFORMATION 


ACID 

ACTUATOR ID NUMBER 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


TYPE = INTEGER UNITS 

ACTUATOR 

DEFINE CONTROL SYSTEM 
GENERATE LINEAR SYSTEMS MATRICES 


ALPHA1 TYPE = REAL UNITS 

TRANSVERSE SHEAR DEFLECTION CONSTANT, PLANE 1 
RELATIONS USED IN: BEAMPROP 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


ALPHA2 TYPE = REAL UNITS 

TRANSVERSE SHEAR DEFLECTION CONSTANT, PLANE 2 
RELATIONS USED IN: BEAMPROP 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 

ANALYST TYPE = REAL UNITS 

NAME OF CONTROLS ANALYST 
RELATIONS USED IN: SIMULATE 

ORIGIN: RECORD CONTROL SIMULATION 

DESTINATION: USER'S INFORMATION 


AREA TYPE = REAL UNITS 

CROSS-SECTIONAL AREA 
RELATIONS USED IN: BEAMPROP 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


DIMENSIONLESS 


DIMENSIONLESS 


DIMENSIONLESS 


DIMENSIONLESS 


DIMENSIONLESS 


DIMENSIONLESS 


DIMENSIONLESS 


L**2 
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APPLFOR 

APPLIED FORCE 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = REAL 
NODELOAD 

SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


UNITS = ML**2/T**2 or 
ML/T**2 


A XIS TYPE = INTEGER 

1,2,3 FOR X, Y, Z TRANSLATION 4.5,6 FOR X. Y, Z ROTATION 
RELATIONS USED IN: SENSOR 

ORIGIN' DEFINE CONTROL SYSTEM 

DESTINATION: GENERATE LINEAR SYSTEMS MATRICES 


UNITS = DIMENSIONLESS 


BMREFER TYPE = INTEGER 

BEAM-ORIENTATION REFERENCE NUMBER 
RELATIONS USED IN: BEAMREF, BEAMS. SCRREL 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


UNITS = DIMENSIONLESS 


CG TYPE = RVEC 3 UNITS = L 

CENTER OF MASS (X, Y. Z) 

RELATIONS USED IN: 

ORIGIN: 

DESTINATION: 


R1GPROP 

MSC/NASTRAN 

GENERATE LINEAR SYSTEMS MATRICES 


TYPE = INTEGER 


CID 

COORDINATE FRAME ID 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


CONMASS 

SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


UNITS = DIMENSIONLESS 


CMPONENT 
GROUP NUMBER 
RELATIONS USED IN: 

ORIGIN: 

DESTINATION: 


TYPE= INTEGER UNITS = DIMENSIONLESS 

BEAMS, BEAMSTRS. ELEMLOAD, MODELDEF, 

TRIANGLS, QUADS, RIGIDBAR. STRNENG, SCRREL 
SUPERTAB 

MSC/NASTRAN, SUPERTAB 


CONDNUM 


TYPE = INTEGER 


LOAD-CASE ID, OR MODE NUMBER 


RELATIONS USED IN: 

ORIGIN: 
DESTINATION: 


E1GNVECT, E1GNVALS, ELEMLOAD, 
NODELOAD, STRNENG 
SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN. SUPERTAB 


UNITS = DIMENSIONLESS 


CONDUCT 
CONDUCTIVITY 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = REAL 
MAT-PROP 

SUPERTAB, MSC/NASTRAN 
CURRENTLY UNUSED 


UNITS = BTU(IN-SEC-DEG F) 
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COS-NAST TYPE = TEXT X 

COSMIC NASTRAN ELEMENT TYPE 
RELATIONS USED IN: ELEM-MAP 

0RIG,N; CREATE DATABASE 

DESTINATION: CURRENTLY UNUSED 


UNITS = DIMENSIONLESS 


COS-SECT TYPE = TEXT 8 

COSMIC NASTRAN SECTION PROPERTY 
RELATIONS USED IN: ELEM-MAP 

ORIGIN: CREATE DATABASE 

DESTINATION: CURRENTLY UNUSED 


UNITS = DIMENSIONLESS 


CONTROLS TYPE = IVEC I VAR 

ID NUMBERS (ACID'S) OF ACTUATORS 
RELATIONS USED IN: SYSTEM 

0R,G1N DEFINE CONTROL SYSTEM 

DESTINATION: GENERATE LINEAR SYSTEMS MATRICES 


UNITS = DIMENSIONLESS 


CSYSTYPE TYPE = TEXT 80 

TYPE OF CONTROL SYSTEM 
RELATIONS USED IN DBDESC 

ORIG,N; DEFINE CONTROL SYSTEM 

DESTINATION: USER'S INFORMATION 


UNITS = DIMENSIONLESS 


damprat 

MODAL DAMPING RATIO 
RELATIONS USED IN 
ORIGIN: 

DESTINATION: 


TYPE = REAL 


UNITS = DIMENSIONLESS 


EIGNVALS 

DEFINE CONTROL SYSTEM 
GENERATE LINEAR SYSTEMS MATRICES 


DATECRE TYPE = DATE 

DATE DATABASE WAS CREATED 
RELATIONS USED IN: DBDESC 

0R1GIN: CREATE DATABASE 

DESTINATION: USER'S INFORMATIO 


UNITS = DIMENSIONLESS 


DBDESC 

DATABASE DESCRIPTION 
RELATIONS USED IN. 
ORIGIN: 

DESTINATION- 


TYPE = TEXT 80 
DBDESC 

CREATE DATABASE 
USER'S INFORMATION 


DELTAT 

UNIFORM TIME STEP 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = REAL 

DYNFORCE, SIMULATE 
RECORD CONTROL SIMULATION 
RECOVER PHYSICAL OUTPUT 


UNITS = DIMENSIONLESS 


UNITS = T 
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DEPDOFA TYPE = INTEGER 

DEPENDENT DOE AT END A 
RELATIONS USED IN: RIGIDBAR 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


UNITS = 


DEPDOFB TYPE = INTEGER 

DEPENDENT DOF AT END B 
RELATIONS USED IN: RIGIDBAR 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN. SUPERTAB 


UNITS = 


DESCRIPT TYPE = TEXT 50 UNITS 

TEXT DESCRIPTION FOR THIS ELEMENT TYPE AND GROUP NUMBER 


RELATIONS USED IN: 

ORIGIN: 

DESTINATION: 


MODELDEF 

SUPERTAB 

USER'S INFORMATION 


DIFFCOMP 
DIFFUSE COMPONENT 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = REAL 

MAT-PROP 
CURRENTLY UNUSED 
CURRENTLY UNUSED 


UNITS = 


DISPFILE TYPE = TEXT 40 

NAME OF FILE CONTAINING MODAL DISPLACEMENTS 

RELATIONS USED IN: SIMULATE 

ORIGIN: RECORD CONTROL SIMULATION 

DESTINATION: RECOVER PHYSICAL OUTPUT 


UNITS = 


DLASTMOD TYPE = DATE 

DATE OF LAST MODIFICATION 
RELATIONS USED IN: DBDESC 

ORIGIN: DATABASE OWNER 

DESTINATION: USER'S INFORMATION 


UNITS = 


DLOADFIL TYPE = TEXT 40 

LOAD/FORCE TIME HISTORY FILE NAME 


UNITS = 


RELATIONS USED IN: 

ORIGIN: 

DESTINATION: 


DYNFORCE 

RECORD CONTROL SIMULATION 
RECOVER PHYSICAL OUTPUT 


EAL-ELT 

EAL ELEMENT TYPE 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = TEXT 8 
SCRREL 

CREATE DATABASE 
CURRENTLY UNUSED 


UNITS 


DIMENSIONLESS 


DIMENSIONLESS 


DIMENSIONLESS 


DIMENSIONLESS 


DIMENSIONLESS 


DIMENSIONLESS 


DIMESNIONLESS 


DIMENSIONLESS 
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EAL-SEC 
EAL SECTION TYPE 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 

EIGENDOC 
DESCRIPTION OF MODE 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


TYPE = TEXT 8 
SCRREL 

CREATE DATABASE 
CURRENTLY UNUSED 


TYPE = TEXT VAR 
OR FREQUENCY 
EIGENVALS 

DEFINE CONTROL SYSTEM 
USER'S INFORMATION 


UNITS = DIMENSIONLESS 


UNITS = DIMENSIONLESS 


EL-TYPE 

IMAT ELEMENT TYPE 
RELATIONS USED IN. 

ORIGIN: 

DESTINATION: 


TYPE = TEXT 8 UNITS = DIMENSIONLESS 

BEAMS. ELEM-MAP, MODELDEF. TRIANGLS, 

SCRREL, STRNENG, QUADS, RIGIDBAR 
LOAD UNIVERSAL FILE. LOAD BULK DATA 
FORMAT BULK DATA. FORMAT UNIVERSAL FILE 


ELD 

ELEMENT TYPE 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = TEXT 8 UNITS = DIMENSIONLESS 

SCRREL 

FORMAT BULK DATA. LOAD BULK DATA 
INTERNAL USE ONLY 


ELEMENT 
ELEMENT NUMBER 
RELATIONS USED IN: 

ORIGIN: 

DESTINATION: 


TYPE = INTEGER UNITS = DIMENSIONLESS 

BEAMS, BEAMSTRS. CONMASS, ELEMLOAD, 

QUADS, STRNENG, TRIANGLS, RIGIDBAR 
SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


EMISSIV 
EMISSIVITY 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = REAL 

MAT-PROP 

SUPERTAB 

CURRENTLY UNUSED 


UNITS = DIMENSIONLESS 


ENDU-LIM 
ENDURANCE LIMIT 
RELATIONS USED IN 
ORIGIN: 
DESTINATION: 


TYPE = REAL 

MAT-PROP 
CURRENTLY UNUSED 
CURRENTLY UNUSED 


UNITS = M/(LT**2) 
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EVECFNAM 

NAME OF RAPID-ACCESS 

RELATIONS USED IN: 

ORIGIN: 

DESTINATION: 


TYPE = TEXT 40 UNITS = DIMENSIONLESS 

EIGENVECTOR FILE 
EVECINFO 

LOAD ANALYSIS RESULTS 
GENERATE LINEAR SYSTEMS MATRICES, 

QUERY EIGENVECTOR FILE 


EXAPDOC TYPE = TEXT VAR 

DESCRIPTION OF EXTERNAL FORCE/TORQUE 
RELATIONS USED IN: EXTFTAP 

ORIGIN: DEFINE CONTROL SYSTEM 

DESTINATION: USER'S INFORMATION 


UNITS = DIMENSIONLESS 


EXAPID TYPE = INTEGER 

EXTERNAL FORCE/TORQUE ID NUMBER 
RELATIONS USED IN: EXTFTAP 

ORIGIN: DEFINE CONTROL SYSTEM 

DESTINATION: GENERATE LINEAR SYSTEMS MATRICES 


UNITS = DIMENSIONLESS 


EXFORTOR 

ID NUMBERS (EXAPID S) 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


TYPE = IVEC VAR UNITS = DIMENSIONLESS 

OF EXTERNAL FORCE/TORQUE 
SYSTEM 

DEFINE CONTROL SYSTEM 
GENERATE LINEAR SYSTEMS MATRICES 


FI TYPE = REAL 

NON-UNIFORM TORSION CONSTANT 
RELATIONS USED IN: BEAMPROP 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: CURRENTLY UNUSED 

FF TYPE = REAL 

UNIFORM TORSION CONSTANT 
RELATIONS USED IN: BEAMPROP 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


UNITS = DIMENSIONLESS 


UNITS = DIMENSIONLESS 


FMDIRECT TYPE = INTEGER 

FORCE OR MOMENT DIRECTION (1-6) 

RELATIONS USED IN: NODELOAD 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


UNITS = DIMENSIONLESS 
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FORCID TYPE = INTEGER UNITS = DIMENSIONLESS 

ID NUMBER OF CONTROL FORCE (ACID) OR OF APPLIED LOAD (EXAPID) 

RELATIONS USED IN: DYNFORCE 

ORIGIN: RECORD CONTROL SIMULATION 

DESTNATION: RECOVER PHYSICAL OUTPUT 

FORCTORQ TYPE = RVEC 6 UNITS = DIMENSIONLESS 

X.Y.Z FORCE AND X, Y, Z TORQUE RESULTING FROM A UNIT INPUT 
RELATIONS USED IN: ACTUATOR, EXTFTAP 

ORIGIN: DEFINE CONTROL SYSTEM 

DESTINATION: GENERATE LINEAR SYSTEMS MATRICES 


FREQHZ TYPE = REAL UNITS = 1/T 

CYCLIC FREQUENCY (HERTZ) 

RELATIONS USED IN: EIGNVALS 

ORIGIN: MSC/NASTRAN, DEFINE CONTROL SYSTEM 

DESTINATION: SUPERTAB, GENERATE LINEAR SYSTEMS MATRICES 


FREQRPS 

CIRCULAR FREQUENCY 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


TYPE = REAL UNITS = RAD/T 

EIGNVALS 

MSC/NASTRAN, DEFINE CONTROL SYSTEM 
SUPERTAB. GENERATE LINEAR SYSTEMS MATRICES 


II 

PRINCIPAL MOMENT OF 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


TYPE = REAL 
INERTIA, PLANE 1 (IZZ) 
BEAMPROP 

SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


UNITS = L**4 


111 TYPE = REAL UNITS = ML**2 

MASS MOMENT OF INERTIA 

RELATIONS USED IN: CONMASS 

ORIGIN SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN.SUPERTAB 

1 12 A TYPE = REAL UNITS = L**4 

AREA PRODUCT OF INERTIA 

RELATIONS USED IN: BEAMPROP 

ORIGIN: SUPERTAB. MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


12 TYPE = REAL UNITS = L**4 

PRINCIPAL MOMENT OF INERTIA, PLANE 2 (IYY) 

RELATIONS USED IN: BEAMPROP 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 
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121 

TYPE = REAL 

MASS MOMENT OF INERTIA 

RELATIONS USED IN: 

CONMASS 

ORIGIN: 

SUPERTAB, MSC/NASTRAN 

DESTINATION: 

MSC/NASTRAN, SUPERTAB 

122 

TYPE = REAL 

MASS MOMENT OF INERTIA 

RELATIONS USED IN: 

CONMASS 

ORIGIN: 

SUPERTAB, MSC/NASTRAN 

DESTINATION: 

MSC/NASTRAN, SUPERTAB 

131 

TYPE = REAL 

MASS MOMENT OF INERTIA 

RELATIONS USED IN: 

CONMASS 

ORIGIN: 

SUPERTAB, MSC/NASTRAN 

DESTINATION: 

MSC/NASTRAN, SUPERTAB 

132 

TYPE = REAL 

MASS MOMENT OF INERTIA 

RELATIONS USED IN: 

CONMASS 

ORIGIN: 

SUPERTAB, MSC/NASTRAN 

DESTINATION: 

MSC/NASTRAN, SUPERTAB 

133 

TYPE = REAL 

MASS MOMENT OF INERTIA 

RELATIONS USED IN: 

CONMASS 

ORIGIN: 

SUPERTAB, MSC/NASTRAN 

DESTINATION: 

MSC/NASTRAN. SUPERTAB 

INDDOFA 

TYPE = INTEGER 

INDEPENDENT DOF AT END A 

RELATIONS USED IN: 

R1GIDBAR 

ORIGIN: 

SUPERTAB, MSC/NASTRAN 

DESTINATION: 

MSC/NASTRAN, SUPERTAB 

1NDDOFB 

TYPE = INTEGER 

INDEPENDENT DOF AT END B 

RELATIONS USED IN: 

RIGIDBAR 

ORIGIN: 

SUPERTAB, MSC/NASTRAN 

DESTINATION: 

MSC/NASTRAN, SUPERTAB 


UNITS = ML**2 


UNITS = ML**2 


UNITS = ML**2 


UNITS = ML**2 


UNITS = ML**2 


UNITS = DIMENSIONLESS 


UNITS = DIMENSIONLESS 
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MASMOMIN TYPE = RMAT3.3 

RIGID-BODY MASS MOMENT OF INERTIA MATRIX 

r> m A Tirwio » ... IU1A 


UNITS = ML**2 


RELATIONS USED IN 
ORIGIN: 
DESTINATION: 


RIGPROP 
MSC/NASTRAN 

GENERATE LINEAR SYSTEMS MATRICES 


MASS 

MASS 

RELATIONS USED IN- 
ORIGIN: 


DESTINATION: 


TYPE = REAL 
CONMASS 

SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


UNITS =M 


MASSMAT TYPE = R MAT 3,3 

RIGID-BODY MASS MATRIX 
RELATIONS USED IN: RIGPROP 

ORIGIN: MSC/NASTRAN 

DESTINATION: GENERATE LINEAR SYSTEMS MATRICES 


UNITS 


ML**2 


MATERIAL 
MATERIAL NAME OR ID 
RELATIONS USED IN- 
ORIGIN: 

DESTINATION: 


TYPE = TEXT 8 
NUMBER 


UNITS = DIMENSIONLESS 


BEAMS, MAT-PROP, TRIANGLS, QUADS 
SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


MATNUM 
MATERIAL NUMBER 
RELATIONS USED IN- 
ORIGIN: 
DESTINATION: 


TYPE = INTEGER 


UNITS = DIMENSIONLESS 


SCRREL 

FORMAT BULK DATA, LOAD BULK DATA 
MSC/NASTRAN 


MOD-ELAS 

MODULUS OF ELASTICITY 
RELATIONS USED IN- 
ORIGIN: 

DESTINATION. 


TYPE = REAL 
MAT-PROP 

SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


MOD-RIGI 

MODULUS OF RIGIDITY 
RELATIONS USED IN 
ORIGIN: 

DESTINATION. 


type= real 
MAT-PROP 

SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


UNITS = M/(LT**2) 


UNITS = M/(LT**2) 


MODES TYPE = IVEC VAR 

VIBRATION (>0) OR NEWTONIAN RIGID BODY(-l TO -6) MODES 
RELATIONS USED IN: SYSTEM o) MODES 

« DEFINE CONTROL SYSTEM 

DESTINATION: GENERATE LINEAR SYSTEMS MATRICES 


UNITS = DIMENSIONLESS 
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MSC-N AST TYPE = TEXTS 

MSC/NASTRAN ELEMENT TYPE 
RELATIONS USED IN: ELEM-MAP 

ORIGIN: CREATE DATABASE 

DESTINATION: FORMAT BULK DATA, LOAD BULK DATA 


UNITS = DIMENSIONLESS 


MSC-SEC TYPE = TEXT 8 

MSC/NASTRAN SECTION PROPERTY 
RELATIONS USED IN: ELEM-MAP 

ORIGIN: CREATE DATABASE 

DESTINATION: FORMAT BULK DATA, LOAD BULK DATA 


UNITS = DIMENSIONLESS 


NODE1 TYPE= INTEGER 

FIRST NODE IN ELEMENT CONNECTIVITY 

RELATIONS USED IN: BEAMS, TRIANGLS, QUADS, RIG1DBAR, SCRREL 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


UNITS = DIMENSIONLESS 


NODE2 TYPE = INTEGER UNITS = DIMENSIONLESS 

SECOND NODE IN ELEMENT CONNECTIVITY 

RELATIONS USED IN: BEAMS, TRIANGLS, QUADS, RIGIDBAR, SCRREL 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


NODE3 TYPE = INTEGER 

THIRD NODE IN ELEMENT CONNECTIVITY 
RELATIONS USED IN: QUADS, TRIANGLS. SCRREL 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


UNITS = DIMENSIONLESS 


NODE4 TYPE = INTEGER UNITS = DIMENSIONLESS 

FOURTH NODE IN ELEMENT CONNECTIVITY 
RELATIONS USED IN: QUADS, SCRREL 

ORIGIN: LOAD BULK DATA. SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


NODENUM TYPE = INTEGER UNITS = DIMENSIONLESS 

NODE NUMBER 

RELATIONS USED IN: ACTUATOR, CONMASS, CONSTRN, 

EIGNVECT.NODES.NODELOAD, EXTFTAP, 

MAT-PROP. SENSOR 

ORIGIN: SUPERTAB, MSC/NASTRAN, DEFINE CONTROL SYSTEM 

DESTINATION: MSC/NASTRAN, SUPERTAB, 

GENERATE LINEAR SYSTEMS MATRICES 
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NODEREF TYPE = INTEGER 

NODE NUMBER DEFINING BEAM ORIENTATION PLANE 

RELATIONS USED IN: BEAMREF 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


UNITS = DIMENSIONLESS 


NOM-SIZE 
PHYSICAL PROPERTY 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = TEXTS 
NAME OR ID NUMBER 
BEAMS, SCRREL 
LOAD BULK DATA, SUPERTAB 
MSC/NASTRAN, SUPERTAB 


UNITS = DIMENSIONLESS 


, MSC/NASTRAN 


NONSTYVHB TYPE = REAL 

NON-STRUCTURAL MASS PER UNIT LENGTH 

RELATIONS USED IN: BEAMS 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


UNITS = M/L 


NONSTWHT 
NON-STRUCTURAL MASS 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


TYPE = REAL UNITS = 

PER UNIT AREA 

QUADS, SCRREL, TRIANGLS 

LOAD BULK DATA, SUPERTAB, MSC/NASTRAN 

MSC/NASTRAN, SUPERTAB 


M/L**2 


NUMMODES 
NUMBER OF MODES 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = INTEGER 
EVECINFO 

CURRENTLY UNUSED 
CURRENTLY UNUSED 


NUMNODES 
NUMBER OF NODES 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = INTEGER 
EVECINFO 

CURRENTLY UNUSED 
CURRENTLY UNUSED 


OPTP TYPE = TEXT 40 

MSC/NASTRAN OLD PROBLEM TAPE 

(NAME OF NPTP CREATED BY NORMAL MODES ANALYSIS) 
RELATIONS USED IN: EVECINFO 

0R1G,N LOAD ANALYSIS RESULTS 

DESTINATION: USER'S INFORMATION 


UNITS = DIMENSIONLESS 


UNITS = DIMENSIONLESS 


UNITS = DIMENSIONLESS 


PA 

PIN FLAG END A 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = INTEGER 
BEAMS 

SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


UNITS = DIMENSIONLESS 
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TYPE = TEXT 8 


I'AT-ELEM 

PATRAN ELEMENT TYPE 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 

PB 

PIN FLAG END B 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


ELEM-MAP 
CREATE DATABASE 
CURRENTLY UNUSED 


BEAMS 

SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN 


TYPE = INTEGER 


PERCENT TYPE = REAL 

PERCENT OF TOTAL STRAIN ENERGY 
RELATIONS USED IN: STRNENG 

ORIGIN: MSC/NASTRAN 

DESTINATION: USER'S INFORMATION 


PHONE TYPE = TEXT 15 

PHONE NUMBER OF RP (RESPONSIBLE PERSON) 
RELATIONS USED IN: DBDESC 

ORIGIN: CREATE DATABASE 

DESTINATION: USER'S INFORMATION 


PRESLOAD TYPE = REAL 

ELEMENT PRESSURE LOAD 
RELATIONS USED IN: ELEMLOAD 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


PROJECT 
PROJECT NAME 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = TEXT 1 2 
DBDESC 

CREATE DATABASE 
USER'S INFORMATION 


PUNCH FI L TYPE = TEXT = 40 

MSC/NASTRAN PUNCH FILE CONTAINING EIGENVECTORS 
AND CHECKPOINT DICTIONARY 
RELATIONS USED IN: EVECINFO 

ORIGIN: LOAD ANALYSIS RESULTS 

DESTINATION: MSC/NASTRAN 


UNITS = DIMENSIONLESS 


UNITS = DIMENSIONLESS 


UNITS = DIMENSIONLESS 


UNITS = DIMENSIONLESS 


UNITS = M/(LT**2) 


UNITS = DIMENSIONLESS 


UNITS = DIMENSIONLESS 


RIMNUM TYPE = INTEGER UNITS = DIMENSIONLESS 

IMAT ELEMENT NUMBERING COUNTER 
RELATIONS USED IN: SCRREL 

ORIGIN: FORMAT BULK DATA, LOAD BULK DATA 

DESTINATION: INTERNAL USE ONLY 
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ROWNUM 
ROW NUMBER 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = INTEGER 


UNITS = DIMENSIONLESS 


E1CNVALS, NODES 

MSC/NASTRAN, DEFINE CONTROL SYSTEM 
GENERATE LINEAR SYSTEMS MATRICES 


RP 

RESPONSIBLE PERSON 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION. 


TYPE = TEXT 12 
DBDESC 

CREATE DATABASE 
USER'S INFORMATION 


UNITS = DIMENSIONLESS 


SECTTYPE 
SECTION TYPE 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = TEXT 8 


UNITS = DIMENSIONLESS 


SCRREL 

FORMAT BULK DATA, LOAD BULK DATA 
MSC/NASTRAN 


SECNUM 
SECTION NUMBER 
RELATIONS USED IN 
ORIGIN: 
DESTINATION: 


TYPE = INTEGER 


UNITS = DIMENSIONLESS 


SCRREL 

FORMAT BULK DATA. LOAD BULK DATA 
MSC/NASTRAN 


SENDOC 

DESCRIPTION OF SENSOR 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


TYPE = TEXT 
SENSOR 

DEFINE CONTROL SYSTEM 
USER'S INFORMATION 


UNITS = DIMENSIONLESS 


SENSID 

SENSOR ID NUMBER 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = INTEGER 


UNITS = DIMENSIONLESS 


SENSOR 

DEFINE CONTROL SYSTEM 
GENERATE LINEAR SYSTEMS MATRICES 


SENSORS TYPE = IVEC VAR 

ID NUMBERS (SENSID'S) OF SENSORS 
RELATIONS USED IN: SYSTEM 


UNITS = DIMENSIONLESS 


ORIGIN: DEFINE CONTROL SYSTEM 

DESTINATION GENERATE LINEAR SYSTEMS MATRICES 


SIMDATE 

DATE OF SIMULATION 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


TYPE = DATE 
SIMULATE 

RECORD CONTROL SIMULATION 
RECOVER PHYSICAL OUTPUT 


UNITS = DIMENSIONLESS 
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SIMDOC TYPE = TEXT 80 

DESCRIPTION OE SIMULATION 
RELATIONS USED IN: SIMULATE 

ORIGIN: RECORD CONTROL SIMULATION 

DESTINATION: USER'S INFORMATION 


UNITS = 


SI MID TYPE = INTEGER 

SIMULATION ID NUMBER 
RELATIONS USED IN: DYNFORCE 

ORIGIN: RECORD CONTROL SIMULATION 

DESTINATION: RECOVER PHYSICAL OUTPUT 


UNITS = 


SPARNUM TYPE = REAL 

ELEMENT NUMBERING COUNTER 


UNITS = 


REALTIONS USED IN: 

ORIGIN: 

DESTINATION: 


SCRREL 

FORMAT BULK DATA, LOAD BULK DATA 
INTERNAL USE ONLY 


SPEC-WT 
SPECIFIC MASS 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = REAL 
MAT-PROP 

SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


SPECHEAT 
SPECIFIC HEAT 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = REAL 
MAT-PROP 

SUPERTAB. MSC/NASTRAN 
CURRENTLY UNUSED 


STENB TYPE = REAL 

BENDING STRAIN ENERGY 
RELATIONS USED IN: STRNENG 

ORIGIN: MSC/NASTRAN 

DESTINATION: USER'S INFORMATION 

STENBD TYPE = REAL 

BENDING STRAIN ENERGY DENSITY 
RELATIONS USED IN: STRNENG 

ORIGIN: MSC/NASTRAN 

DESTINATION: USER'S INFORMATION 


STENMB TYPE = REAL 

MEMBRANE-BENDING STRAIN ENERGY 
RELATIONS USED IN: STRNENG 

ORIGIN: 

DESTINATION: 


MSC/NASTRAN 
USER'S INFORMATION 


UNITS 


UNITS 


UNITS 


UNITS 


UNITS 


DIMENSIONLESS 


DIMENSIONLESS 


DIMENSIONLESS 


= M/L**3 


BTU(LB-DEG F) 


ML**2/T**2 


M/(LT**2) 


ML**2/T**2 
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STENMBD TYPE = REAL UNITS = M/(LT**2) 

MEMBRANE-BENDING STRAIN ENERGY DENSITY 

RELATIONS USED IN: STRNENG 

ORIGIN: MSC/NASTRAN 

DESTINATION: USER'S INFORMATION 

STENMD TYPE = REAL UNITS = M/(LT**2) 

MEMBRANE STRAIN ENERGY DENSITY 

RELATIONS USED IN: STRNENG 

ORIGIN: MSC/NASTRAN 

DESTINATION: USERS INFORMATION 


STENT 

TOTAL STRAIN ENERGY 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


TYPE = REAL 

STRNENG 
MSC/NASTRAN 
USER S INFORMATION 


UNITS = ML**2/T**2 


STEND TYPE = REAL UNITS = M/(LT**2) 

TOTAL STRAIN ENERGY DENSITY 

RELATIONS USED IN: STRNENG 

ORIGIN: MSC/NASTRAN 

DESTINATION: USER'S INFORMATION 


STRNCOL TYPE = INTEGER UNITS = DIMENSIONLESS 

COLOR FOR A GROUP OF ELEMENTS 

RELATIONS USED IN: STRNENG 

ORIGIN: CURRENTLY UNUSED 

DESTINATION: CURRENTLY UNUSED 


SYS DOC 

DESCRIPTION OF SYSTEM 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


TYPE = TEXT 80 
SYSTEM 

DEFINE CONTROL SYSTEM 
USER'S INFORMATION 


UNITS = DIMENSIONLESS 


SYSID 

SYSTEM ID NUMBER 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = INTEGER UNITS = DIMENSIONLESS 

SIMULATE. SYSTEM 

DEFINE CONTROL SYSTEM 

GENERATE LINEAR SYSTEMS MATRICES. 

RECORD CONTROL SIMULATION 


TEMP 

NODAL TEMPERATURE 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


TYPE = REAL 
NODELOAD 

SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN. SUPFRTAB 


UNITS = DEG F 
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TEMPTYPE 

TEMPORARY TYPE 
RELATIONS USED IN: 
ORIGIN: 

DESINATION: 


TYPE = TEXT 8 


UNITS = DIMENSIONLESS 


SCRREL 

FORMAT BULK DATA, LOAD BULK DATA 
FORMAT BULK DATA, LOAD BULK DATA 


THERMCOE TYPE = REAL UNITS = 1/DEG F 

COEFFICIENT OF THERMAL EXPANSION 

RELATIONS USED IN: MAT-PROP 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


THETA TYPE = REAL UNITS = DEG 

INCLINATION OF PRINCIPAL AXIS WITH ELEMENT 

REFERENCE FRAME 

RELATIONS USED IN: BEAMPROP 

ORIGIN: CURRENTLY UNUSED 

DESTINATION: CURRENTLY UNUSED 

THICKNES TYPE = REAL UNITS = L 

PLATE OR SHELL THICKNESS 

RELATIONS USED IN: QUADS, SCRREL, TRIANGLS 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


TFINAL 

SIMULATION END TIME 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


TYPE = REAL 

DYNFORCE, SIMULATE 
RECORD CONTROL SIMULATION 
RECOVER PHYSICAL OUTPUT 


UNITS = T 


TIN IT TYPE = REAL UNITS = T 

SIMULATION START TIME 

ORIGIN: RECORD CONTROL SIMULATION 

DESTINATION: RECOVER PHYSICAL OUTPUT 


TYPE TYPE = INTEGER UNITS = DIMENSIONLESS 

1 = CONTROL FORCE/TORQUE, 

2 = APPLIED LOAD (EXTERNAL FORCE/TORQUE) 

RELATIONS USED IN: DYNFORCE 

ORIGIN: RECORD CONTROL SIMULATION 

DESTINATION: RECOVER PHYSICAL OUTPUT 

ULT-COMP TYPE = REAL UNITS = M/(LT**2) 

ULTIMATE COMPRESSIVE STRENGTH 

RELATIONS USED IN: MAT-PROP 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: CURRENTLY UNUSED 


APPENDIX A 


A-19 


Attribute Overview 17 


ULT-SHER TYPE = REAL UNITS = M/(LT**2) 

ULTIMATE SHEAR STRENGTH 

RELATIONS USED IN: MAT-PROP 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: CURRENTLY UNUSED 

ULT-TENS TYPE = REAL UNITS = M/(LT**2) 

ULTIMATE TENSILE STRENGTH 

RELATIONS USED IN: MAT-PROP 

ORIGIN: SUPERTAB. MSC/NASTRAN 

DESTINATION: CURRENTLY UNUSED 

UNITS TYPE = TEXT 40 UNITS = DIMENSIONLESS 

DESCRIPTION OF UNITS USED IN DATABASE 

RELATONS USED IN: DBDESC 

ORIGIN: CREATE DATABASE 

DESTINATION: USER’S INFORMATION 


USAGE TYPE = INTEGER UNITS = DIMENSIONLESS 

-1 FOR UNSPECIFIED; OR SUM OF APPLICABLE: 1 FOR POSITION OR 

ANGLE, 2 FOR VELOCITY OR ANGULAR RATE, 4 FOR ACCELERATION 

OR ANGULAR ACCELERATION 

RELATIONS USED IN: SENSOR 

ORIGIN: DEFINE CONTROL SYSTEM 

DESTINATION: GENERATE LINEAR SYSTEMS MATRICES 


X 

X-LOCATION 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 
EST1NATION: 


TYPE = REAL 
NODES 

SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 
SUPERTAB 


UNITS = L 


X-EIGN TYPE = REAL UNITS = L 

X COMPONENT OF THE EIGENVECTOR 
RELATIONS USED IN: EIGNVECT 
ORIGIN: MSC/NASTRAN 

DESTINATION: SUPERTAB, GENERATE LINEAR SYSTEM MATRICES 


X-ROTEN TYPE = REAL UNITS = RAD 

X-AXIS ROTATIONAL COMPONENT OF THE EIGENVECTOR 

RELATIONS USED IN: EIGNVECT 

ORIGIN: LOAD ANALYSIS RESULTS 

DESTINATION: SUPERTAB, GENERATE LINEAR SYSTEMS MATRICES 


XDCON TYPE = TEXT 4 UNITS = DIMENSIONLESS 

CONSTRAINED IN X-DISPLACEMENT? Y OR N 

RELATIONS USED IN: CONSTRN 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 
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XRCON TYPE = TEXT 4 

CONSTRAINED IN X-ROTATION? Y OR N 


UNITS = DIMESNIONLESS 


RELATIONS USED IN 

ORIGIN: 

DESTINATION: 


Y- LOCATION 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


CONSTRN 

SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 

TYPE = REAL 

NODES 

SUPERTAB, MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 

TYPE = REAL 


UNITS = L 


UNITS = L 


Y-EIGN 

Y COMPONENT OF THE EIGENVECTOR 
RELATIONS USED IN: EIGNVECT 

ORIGIN: MSC/NASTRAN 

DESTINATION: SUPERTAB. GENERATE LINEAR SYSTEMS MATRICES 

Y-ROTEN TYPE = REAL UNITS = RAD 

Y-AXIS ROTATIONAL COMPONENT OF THE EIGENVECTOR 
RELATIONS USED IN: EIGNVECT 

ORIGIN: MSC/NASTRAN 

DESTINATION: SUPERTAB, GENERATE LINEAR SYSTEMS MATRICES 


YDCON TYPE = TEXT 4 

CONSTRAINED IN Y-D1SPLACEMENT? Y OR N 
RELATIONS USED IN: CONSTRN 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 

YIELD-CO TYPE = REAL 

YIELD STRENGTH IN COMPRESSION 

RELATIONS USED IN: MAT-PROP 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 

YIELD-SH TYPE = REAL 

YIELD STRENGTH IN SHEAR 

RELATIONS USED IN: MAT-PROP 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 

YIELD-TE TYPE = REAL 

YIELD STRENGTH IN TENSION 

RELATIONS USED IN: MAT-PROP 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


UNITS = DIMENSIONLESS 


UNITS = M/(LT**2) 


UNITS = M/(LT**2) 


UNITS = M/(LT**2) 
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YRCON TYPE = TEXT 4 

CONSTRAINED IN Y-ROTATION? Y OR N 
RELATIONS USED IN CONSTRN 
ORIGIN: SUPERTAB. MSC/NASTRAN 

DESTINATION: MSC/NASTRAN. SUPERTAB 


UNITS = DIMENSIONLESS 


Z 

Z-LOCATION 
RELATIONS USED IN: 
ORIGIN: 
DESTINATION: 


TYPE = REAL 
NODES, 

SUPERTAB. MSC/NASTRAN 
MSC/NASTRAN, SUPERTAB 


UNITS = L 


Z-EIGN TYPE = REAL UNITS = L 

Z COMPONENT OF THE EIGENVECTOR 
RELATIONS USED IN: EIGNVECT 

ORIGIN: MSC/NASTRAN 

DESTINATION: SUPERTAB, GENERATE LINEAR SYSTEMS MATRICES 


Z-ROTEN TYPE = REAL UNITS = RAD 

Z-AXIS ROTATIONAL COMPONENT OF THE EIGENVECTOR 
RELATIONS USED IN: EIGNVECT 

ORIGIN: MSC/NASTRAN 

DESTINATION: SUPERTAB, GENERATE LINEAR SYSTEMS MATRICES 


Z1 

SHEAR CENTER OFFSETS 
RELATIONS USED IN: 
ORIGIN: 

DESTINATION: 


TYPE = REAL 

BEAMPROP 
CURRENTLY UNUSED 
CURRENTLY UNUSED 


Z1A TYPE = REAL 

X-OFFSET OF SHEAR CENTER AT END A 
RELATIONS USED IN: BEAMS 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN. SUPERTAB 


UNITS = L 


UNITS = L 


Z1B TYPE = REAL UNITS = L 

X-OFFSET OF SHEAR CENTER AT END B 

RELATIONS USED IN: BEAMS 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


Z1M TYPE = REAL 

X-OFFSET DISTANCE OF MASS 
RELATIONS USED IN: CONMASS 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 


UNITS = L 
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Z2 

TYPE = REAL 

UNITS = L 

SHEAR CENTER OFFSETS 



RELATIONS USED IN: 

BEAMPROP 


ORIGIN: 

CURRENTLY UNUSED 


DESTINATION: 

CURRENTLY UNUSED 


Z2A 

TYPE = REAL 

UNITS = L 

Y-OFFSET OF SHEAR CENTER AT END A 


RELATIONS USED IN: 

BEAMS 


ORIGIN: 

SUPERTAB, MSC/NASTRAN 


DESTINATION: 

MSC/NASTRAN, SUPERTAB 


Z2B 

TYPE = REAL 

UNITS = L 

Y-OFFSET OF SHEAR CENTER AT END B 


RELATIONS USED IN: 

BEAMS 


ORIGIN: 

SUPERTAB, MSC/NASTRAN 


DESTINATION: 

MSC/NASTRAN, SUPERTAB 


Z2M 

TYPE = REAL 

UNITS = L 

Y-OFFSET DISTANCE OF MASS 


RELATIONS USED IN: 

CONMASS 


ORIGIN: 

SUPERTAB. MSC/NASTRAN 


DESTINATION: 

MSC/NASTRAN, SUPERTAB 


Z3A 

TYPE = REAL 

UNITS = L 

Z-OFFSET OF SHEAR CENTER AT END A 


RELATIONS USED IN: 

BEAMS 


ORIGIN: 

SUPERTAB, MSC/NASTRAN 


DESTINATION: 

MSC/NASTRAN, SUPERTAB 


Z3B 

TYPE = REAL 

UNITS = L 

Z-OFFSET OF SHEAR CENTER AT END B 


RELATIONS USED IN: 

BEAMS 


ORIGIN: 

SUPERTAB, MSC/NASTRAN 


DESTINATION: 

MSC/NASTRAN, SUPERTAB 


Z3M 

TYPE = REAL 

UNITS = L 

Z-OFFSET DISTANCE OF MASS 


RELATIONS USED IN: 

CONMASS 


ORIGIN: 

SUPERTAB, MSC/NASTRAN 


DESTINATION: 

MSC/NASTRAN, SUPERTAB 


ZDCON 

TYPE = TEXT 4 

UNITS = DIMENSIONLESS 

CONSTRAINED IN Z- D I S PL ACE M E NT? Y OR N 


RELATIONS USED IN: 

CONSTRN 


ORIGIN: 

SUPERTAB. MSC/NASTRAN 


DESTINATION: 

MSC/NASTRAN, SUPERTAB 
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ZRCON TYPE = TEXT 4 UNITS = DIMENSIONLESS 

CONSTRAINED IN Z-ROTATION ? Y OR N 

RELATIONS USED IN: CONSTRN 

ORIGIN: SUPERTAB, MSC/NASTRAN 

DESTINATION: MSC/NASTRAN, SUPERTAB 
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ACTUATOR 

ACTUATOR INFORMATION 



ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

ACID 

INTEGER 

ACTUATOR ID NUMBER 

DIMENSIONLESS 

2 

NODENUM 

INTEGER 

NODE NUMBER 

DIMENSIONLESS 

3 

FORCTORQ 

RVEC 6 

X, Y, Z FORCE; X,Y,Z 
TORQUE RESULTING FROM A 
UNIT INPUT 

DIMENSIONLESS 

4 

ACDOC 

TEXT 80 

DESCRIPTION OF ACTUATOR 

DIMENSIONLESS 


BEAMPROP 
BEAM PROPERTIES 



ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

NOM-SIZE 

TEXTS 

PHYSICAL PROPERTY NAME 
OR ID NUMBER 

DIMENSIONLESS 

2 

1 1 

REAL 

PRINCIPAL MOMENT OF 
INERTIA, PLANE 1 (IZZ) 

L* *4 

3 

ALPHA 1 

REAL 

TRANVERSE SHEAR 
DEFLECTION CONSTANT, 
PLANE 1 

DIMENSIONLESS 

4 

12 

REAL 

PRINCIPAL MOMENT OF 
INERTIA, PLANE 2 (IYY) 

L* *4 

5 

ALPHA2 

REAL 

TRANSVERSE SHEAR 
DEFLECTION CONSTANT, 
PLANE 2 

DIMENSIONLESS 

6 

AREA 

REAL 

CROSS-SECTIONAL AREA 

L* *2 

7 

FF 

REAL 

UNIFORM TORSION CONSTANT 

DIMENSIONLESS 

8 

FI 

REAL 

NON-UNIFORM TORSION 
CONSTANT 

DIMENSIONLESS 

9 

Z1 

REAL 

SHEAR CENTER OFFSETS 

L 

10 

Z2 

REAL 

SHEAR CENTER OFFSETS 

L 

1 1 

THETA 

REAL 

INCLINATION OF PRINCIPAL 
AXIS WITH ELEMENT REFERENCE 
FRAME 

DEG 

12 

1 1 2 A 

REAL 

AREA PRODUCT OF INERTIA 

L* *4 
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BEAMREF 

BEAM REFERENCE 



ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

BMREFER 

INTEGER 

BEAM-ORIENTATION 

DIMENSIONLESS 




REFERENCE NUMBER 


2 

X 

REAL 

X-LOCATION 

L 

3 

Y 

REAL 

Y-LOCATION 

L 

4 

Z 

REAL 

Z-LOCATION 

L 

5 

NODEREF 

INTEGER 

NODE NUMBER DEFINING 

DIMENSIONLESS 


BEAM ORIENTATION PLANE 


BEAMS 

TWO NODE ELEMENTS 



ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

CMPONENT 

INTEGER 

GROUP NUMBER 

DIMENSIONLESS 

2 

ELEMENT 

INTEGER 

ELEMENT NUMBER 

DIMENSIONLESS 

3 

NODE1 

INTEGER 

FIRST NODE IN ELEMENT 
CONNECTIVITY 

DIMENSIONLESS 

4 

NODE2 

INTEGER 

SECOND NODE IN ELEMENT 
CONNECTIVITY 

DIMENSIONLESS 

5 

EL-TYPE 

TEXT 8 

ELEMENT TYPE 

DIMENSIONLESS 

6 

NOM-SIZE 

TEXTS 

PHYSICAL PROPERTY OR 
ID NUMBER 

DIMENSIONLESS 

7 

MATERIAL 

TEXTS 

MATERIAL NAME OR 
ID NUMBER 

DIMENSIONLESS 

8 

BMREFER 

INTEGER 

BEAM-ORIENTATION 
REFERENCE NUMBER 

DIMENSIONLESS 

9 

NONSTWHB 

REAL 

NON-STRUCTURAL MASS 
PER UNIT LENGTH 

M/L 

10 

Z1A 

REAL 

X-OFFSET OF SHEAR CENTER-END A 

L 

1 1 

Z2A 

REAL 

Y-OFFSET OF SHEAR CENTER-END A 

L 

12 

Z3A 

REAL 

Z-OFFSET OF SHEAR CENTER-END A 

L 

13 

Z1B 

REAL 

X-OFFSET OF SHEAR CENTER-END B 

L 

14 

Z2B 

REAL 

Y-OFFSET OF SHEAR CENTER-END B 

L 

15 

Z3B 

REAL 

Z-OFFSET OF SHEAR CENTER-END B 

L 

16 

PA 

INTEGER 

PIN FLAG END A 

DIMENSIONLESS 

17 

PB 

INTEGER 

PIN FLAG END B 

DIMENSIONLESS 
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CONMASS 

CONCENTRATED MASS 



ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

ELEMENT 

INTEGER 

ELEMENT NUMBER 

DIMENSIONLESS 

2 

NODENUM 

INTEGER 

NODE NUMBER 

DIMENSIONLESS 

3 

MASS 

REAL 

MASS 

M 

4 

111 

REAL 

MASS MOMENT OF INERTIA 

ML**2 

5 

121 

REAL 

MASS MOMENT OF INERTIA 

ML**2 

6 

122 

REAL 

MASS MOMENT OF INERTIA 

ML**2 

7 

131 

REAL 

MASS MOMENT OF INERTIA 

ML**2 

8 

132 

REAL 

MASS MOMENT OF INERTIA 

ML**2 

9 

133 

REAL 

MASS MOMENT OF INERTIA 

ML**2 

10 

Z1M 

REAL 

X-OFFSET DISTANCE OF MASS 

L 

1 1 

Z2M 

REAL 

Y-OFFSET DISTANCE OF MASS 

L 

12 

Z3M 

REAL 

Z-OFFSET DISTANCE OF MASS 

L 

13 

CID 

INTEGER 

COORDINATE FRAME ID 

DIMENSIONLESS 


CONSTRN 

NODAL CONSTRAINTS 



ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

NODENUM 

INTEGER 

NODE NUMBER 

DIMENSIONLESS 

2 

XDCON 

TEXT 4 

CONSTRAINED IN 

X-D IS PLACEMENT Y OR N 

DIMENSIONLESS 

3 

YDCON 

TEXT 4 

CONSTRAINED IN 
Y-D1SPLACEMENT Y OR N 

DIMENSIONLESS 

4 

ZDCON 

TEXT 4 

CONSTRAINED IN 
Z-DIS PLACEMENT Y OR N 

DIMENSIONLESS 

5 

XRCON 

TEXT 4 

CONSTRAINED IN 
X-ROTATION Y OR N 

DIMENSIONLESS 

6 

YRCON 

TEXT 4 

CONSTRAINED IN 
Y-ROTATION Y OR N 

DIMENSIONLESS 

7 

ZRCON 

TEXT 4 

CONSTRAINED IN 
Z-ROTATION Y OR N 

DIMENSIONLESS 


APPENDIX A 


A-27 


Schema 4 


DBDESC 

DATABASE DESCRIPTION 



ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

PROJECT 

TEXT 12 

PROJECT NAME 

DIMENSIONLESS 

2 

RP 

TEXT 12 

RESPONSIBLE PERSON (DATABASE 
OWNER) 

DIMENSIONLESS 

3 

PHONE 

TEXT 15 

PHONE NUMBER OF RP 

DIMENSIONLESS 

4 

DATECRE 

DATE 

DATE DATABASE WAS CREATED 

DIMENSIONLESS 

5 

DLASTMOD 

DATE 

DATE OF LAST MODIFICATION 

DIMENSIONLESS 

6 

DBDESC 

TEXT 80 

DATABASE DESCRIPTION 

DIMENSIONLESS 

7 

CSYSTYPE 

TEXT 80 

TYPE OF CONTROL SYSTEM MODELED 

DIMENSIONLESS 

8 

UNITS 

TEXT 40 

DESCRIPTION OF UNITS USED 

DIMENSIONLESS 


DYNFORCE 

SIMULATION INFORMATION 



ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

SIMID 

INTEGER 

SIMULATION ID NUMBER 

DIMENSIONLESS 

2 

DLOADFIL 

TEXT 40 

LOAD/FORCE TIME HISTORY FILE 

DIMENSIONLESS 

3 

TYPE 

INTEGER 

1 = CONTROL FORCE/TORQUE 

2 = APPLIED LOAD (EXTERNAL 
FORCE/TORQ UE) 

DIMENSIONLESS 

4 

FORCID 

INTEGER 

ID NUMBER (ACID) OF CONTROL 
FORCE OR ID NUMBER (EXPID) 
OF APPLIED LOAD 

DIMENSIONLESS 

5 

TIN IT 

REAL 

SIMUALTION START TIME 

T 

6 

TFINAL 

REAL 

SIMULATION END TIME 

T 

7 

DELTAT 

REAL 

UNIFORM TIME STEP 

T 


EICiNVALS 
EIGENVALUE DATA 



ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

ROWNUM 

INTEGER 

ROW NUMBER 

DIMENSIONLESS 

2 

CONDNUM 

INTEGER 

LOAD-CASE ID 
OR MODE NUMBER 

DIMENSIONLESS 

3 

FREQRPS 

REAL 

CIRCULAR FREQUENCY 

RAD/T 

4 

FREQHZ 

REAL 

CYCLIC FREQUENCY (HERTZ) 

1/T 

5 

DAMPRAT 

REAL 

DAMPING RATIO 


6 

EIGNDOC 

TEXT 80 

DESCRIPTION OF MODE 
OR FREQUENCY 

DIMENSIONLESS 
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Schema 5 


EIGNVECT 
EIGENVECTOR DATA 



ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

NODENUM 

INTEGER 

NODE NUMBER 

DIMENSIONLESS 

2 

X-EIGN 

REAL 

X COMPONENT OF THE 
EIGENVECTOR 

L 

3 

Y-E1GN 

REAL 

Y COMPONENT OF THE 
EIGENVECTOR 

L 

4 

Z-EIGN 

REAL 

Z COMPONENT OF THE 
EIGENVECTOR 

L 

5 

X-ROTEN 

REAL 

X-AXIS ROTATIONAL 
COMPONENT OF THE 
EIGN VECTOR 

RAD 

6 

Y-ROTEN 

REAL 

Y-AXIS ROTATIONAL 
COMPONENT OF THE 
EIGENVECTOR 

RAD 

7 

Z-ROTEN 

REAL 

Z-AXIS ROTATIONAL 
COMPONENT OFTHE 
EIGENVECTOR 

RAD 

8 

CONDNUM 

INTEGER 

LOAD-CASE ID 
OR MODE NUMBER 

DIMENSIONLESS 


ELEMLOAD 


ELEMENT PRESSURE 
ATTRIBUTE 

LOADS 

TYPE 

DESCRIPTION 

UNITS 

1 

CMPONENT 

INTEGER 

GROUP NUMBER 

DIMENSIONLESS 

2 

ELEMENT 

INTEGER 

ELEMENT NUMBER 

DIMENSIONLESS 

3 

PRESLOAD 

REAL 

ELEMENT PRESSURE LOAD 

M/(LT* *2) 

4 

CONDNUM 

INTEGER 

LOAD-CASE ID 
OR MODE NUMBER 

DIMENSIONLESS 
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Schema 6 


EVECINFO 

EIGENVECTOR INFORMATION 


ATTRIBUTE TYPE 


DESCRIPTION 


1 NUMNODES INTEGER 

2 NUMMODES INTEGER 

3 EVECFNAM TYPE 40 

4 PUNCHFIL TEXT 40 


5 OPTP TEXT 40 


NUMBER OF NODES 
NUMBER OF MODES 
RAPID ACCESS EIGENVECTOR 
FILE 

NASTRAN PUNCH FILE 
CONTAINING EIGENVECTORS 
AND CHECKPOINT DICTIONARY FOR 
RESTART 

NASTRAN OLD PROBLEM TAPE 
FROM NORMAL MODES (SOL> 3) 


EXTFTAP 

EXTERNAL FORCE/TORQUE DATA 
ATTRIBUTE TYPE 

1 EXAPID INTEGER 

2 NODENUM INTEGER 

3 FORCTORQ RVEC 6 

4 EXAPDOC TEXT VAR 


ELEM-MAP 
A SCRATCH RELATION 



ATTRIBUTE 

TYPE 

1 

EL-TYPE 

TEXTS 

7 

EAL-ELT 

TEXTS 

3 

EAL-SEC 

TEXTS 

4 

COS-NAST 

TEXTS 

5 

COS SECT 

TEXTS 

6 

MSC-NAST 

TEXTS 

7 

MSC-SECT 

TEXTS 

8 

PAT-ELEM 

TEXTS 


DESCRIPTION 


EXTERNAL FORCE/TORQUE 
ID NUMBER 
NODE NUMBER 
COMPONENTS OF FORCTORQ 
ARE: X.Y.Z FORCE AND 
X,YZ TORQUE RESULTING 
FROM UNIT INPUT 
DESCRIPTION OF EXTERNAL 
FORCE/TORQUE 


DESCRIPTION 


ELEMENT TYPE 
EAL ELEMENT TYPE 
EAL SECTION TYPE 
COSMIC NASTRAN ELEMENT TYPE 
COSMIC NASTRAN SECTION TYPE 
MSC/NASTRAN ELEMENT TYPE 
MSC/NASTRAN SECTION TYPE 
PATRAN ELEMENT TYPE 


UNITS 


DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 


DIMENSIONLESS 


UNITS 


DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 


DIMENSIONLESS 


UNITS 


DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 
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Schema 7 


MAT-PROP 

MATERIAL PROPERTIES 



ATTRIBUTE 

TYPE 

DESCRIPTION 

1 

MATERIAL 

TEXTS 

MATERIAL NAME OR ID NUMBER 

2 

SPEC-WT 

REAL 

SPECIFIC MASS DENSITY 

3 

YIELD-TE 

REAL 

YIELD STRENGTH IN TENSION 

4 

YIELD-CO 

REAL 

YIELD STRENGTH IN COMPRESSION 

5 

YIELD-SH 

REAL 

YIELD STRENGTH IN SHEAR 

6 

ULT-TENS 

REAL 

ULTIMATE TENSILE STRENGTH 

7 

ULT-COMP 

REAL 

ULTIMATE COMPRESSIVE 
STRENGTH 

8 

ULT-SHER 

REAL 

ULTIMATE SHEAR STRENGTH 

9 

ENDU-LIM 

REAL 

ENDURANCE LIMIT 

10 

MOD-ELAS 

REAL 

MODULUS OF ELASTICITY 

1 1 

MOD-RIGI 

REAL 

MODULUS OF RIGIDITY 

12 

THERMCOE 

REAL 

COEFFICIENT OF THERMAL 
EXPANSION 

13 

SPECHEAT 

REAL 

SPECIFIC HEAT 

14 

CONDUCT 

REAL 

CONDUCTIVITY 
(IN-SEC-DEG F) 

15 

EMISSIV 

REAL 

EM1SSIVITY 

16 

ABSORP 

REAL 

ABSORPTIVITY 

17 

DIFFCOMP 

REAL 

DIFFUSE COMPONENT 


MODELDEF 
MODEL DEFINITION 


ATTRIBUTE TYPE 


DESCRIPTION 


1 CMPONENT INTEGER 

2 EL-TYPE TEXTS 

3 DESCRIPT TEXT 50 


GROUP NUMBER 
ELEMENT TYPE 
TEXT DESCRIPTION FOR 
THIS ELEMENT TYPE AND 
GROUP NUMBER 


NODELOAD 

NODAL TEMPERATURE AND LOADS 


ATTRIBUTE 

TYPE 

1 

NODENUM 

INTEGER 

2 

FMDIRECT 

INTEGER 

3 

APPLFOR 

REAL 

4 

TEMP 

REAL 

5 

CONDNUM 

INTEGER 


APPENDIX A 


DESCRIPTION 


NODE NUMBER 
FORCE OR MOMENT 
DIRECTION (1-6) 

APPLIED FORCE OR MOMENT 

NODAL TEMPERATURE 
LOAD-CASE ID OR MODE NUMBER 


UNITS 


DIMENSIONLESS 
M/L**3 
M/(LT* *2) 
M/(LT**2) 

M/(LT* *2) 
M/(LT**2) 

M/(LT* *2) 
M/(LT* *2) 
M/(LT**2) 
M/(LT**2) 
1/DEG F 

BTU/(LB-DEG F) 
BTU 

DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 


UNITS 


DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 


UNITS 


DIMENSIONLESS 

DIMENSIONLESS 

ML/T**2 OR 
ML**2/T**2 
DEGF 

DIMENSIONLESS 
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Schema 8 


NODES 

NODE NUMBERS AND COORDINATES 


ATTRIBUTE TYPE 


1 ROWNUM INT 

2 NODENUM INTEGER 

3 X REAL 

4 Y REAL 

5 Z REAL 


QUADS 

FOUR NODE ELEMENTS 



ATTRIBUTE 

TYPE 

1 

CMPONENT 

INTEGER 

i. 

ELEMENT 

INTEGER 

3 

NODE1 

INTEGER 

4 

NODE2 

INTEGER 

5 

NODE3 

INTEGER 

6 

NODE4 

INTEGER 

7 

EL-TYPE 

TEXTS 

8 

MATERIAL 

TEXTS 

9 

THICKNES 

REAL 

10 

NONSTWHT 

REAL 


RIG PROP 


RIGID-BODY MASS PROPERTIES 


ATTRIBUTE 

TYPE 

1 

MASS MAT 

RMAT 3.3 

2 

MAS MOM IN 

RMAT 3.3 

3 

CG 

RVEC 3 


DESCRIPTION 


ROW NUMBER 
NODE NUMBER 
X-LOCATION 
Y-LOCATION 
Z-LOCATION 


DESCRIPTION 


GROUP NUMBER 

ELEMENT NUMBER 

FIRST NODE IN ELEMENT 

CONNECTIVITY 

SECOND NODE IN ELEMENT 

CONNECTIVITY 

THIRD NODE IN ELEMENT 

CONNECTIVITY 

FOURTH NODE IN ELEMENT 

CONNECTIVITY 

ELEMENT TYPE 

MATERIAL NAME OR 

ID NUMBER 

PLATE OR SHELL THICKNESS 
NON-STRUCTURAL MASS 
PER UNIT AREA 


DESCRIPTION 


RIGID-BODY MASS MATRIX 
RIGID-BODY MASS MOMENT 
OF INERTIA MATRIX 
CENTER OF MASS X,Y,Z 


UNITS 


DIMENSIONLESS 

DIMENSIONLESS 


L 

L 

L 


UNITS 


DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 

L 

M/L**2 


UNITS 

M 

ML**2 

L 
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Schema 9 


RICIDBAR 

MSC/NASTRAN RIGID ELEMENTS (RBARS) 



ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

CMPONENT 

INTEGER 

GROUP NUMBER 

DIMENSIONLESS 

2 

ELEMENT 

INTEGER 

ELEMENT NUMBER 

DIMENSIONLESS 

3 

NODE1 

INTEGER 

FIRST NODE IN ELEMENT 

DIMENSIONLESS 




CONNECTIVITY 


4 

NODE2 

INTEGER 

SECOND NODE IN ELEMENT 

DIMENSIONLESS 




CONNECTIVITY 


5 

EL-TYPE 

TEXTS 

ELEMENT TYPE 

DIMENSIONLESS 

6 

INDDOFA 

INTEGER 

INDEPENDENT DOF AT END A 

DIMENSIONLESS 

7 

INDDOFB 

INTEGER 

INDEPENDENT DOF AT END B 

DIMENSIONLESS 

8 

DEPDOFA 

INTEGER 

DEPENDENT DOF AT END A 

DIMENSIONLESS 

9 

DEPDOFB 

INTEGER 

DEPENDENT DOF AT END B 

DIMENSIONLESS 


SCRREL 

A SCRATCH RELATION 


ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

CMPONENT 

INTEGER 

GROUP NUMBER 

DIMENSIONLESS 

n 

RIMNUM 

INTEGER 

RIM ROW NUMBER 

DIMENSIONLESS 

3 

SPARNUM 

INTEGER 

MISCELLENEOUS COUNTER 

DIMENSIONLESS 

4 

EL-TYPE 

TEXTS 

ELEMENT TYPE 

DIMENSIONLESS 

5 

ELD 

TEXTS 

ELEMENT 

DIMENSIONLESS 

6 

NODE1 

INTEGER 

FIRST NODE IN ELEMENT 
CONNECTIVITY 

DIMENSIONLESS 

7 

NODE2 

INTEGER 

SECOND NODE IN ELEMENT 
CONNECTIVITY 

DIMENSIONLESS 

8 

NODE3 

INTEGER 

THIRD NODE IN ELEMENT 
CONNECTIVITY 

DIEMSNIONLESS 

9 

NODE4 

INTEGER 

FOURTH NODE IN ELEMENT 
CONNECTIVITY 

DIMENSIONLESS 

10 

TEMPTYPE 

TEXTS 

TEMPORARY TYPE 

DIMENSIONLESS 

1 1 

MATNUM 

INTEGER 

MATERIAL NUMBER 

DIMENSIONLESS 

12 

SECTYPE 

TEXTS 

SECTION TYPE 

DIMENSIONLESS 

13 

SECNUM 

INTEGER 

SECTION NUMBER 

DIMENSIONLESS 

14 

NOM-SIZE 

TEXTS 

PHYSICAL PROPERTY NAME 
OR ID NUMBER 

DIMENSIONLESS 

15 

THICKNES 

REAL 

PLATE OR SHELL THICKNESS 

L 

16 

BMREFER 

INTEGER 

BEAM-ORIENTATION 
REFERENCE NUMBER 

DIMENSIONLESS 

17 

NONSTWHT 

REAL 

NON-STRUCTURAL MASS 
PER UNIT AREA 

M/L* *2 
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Schema 10 


SENSOR 

SENSOR INFORMATION 


ATTRIBUTE TYPE DESCRIPTION 


UNITS 


1 SENSID INTEGER 

2 NODENUM INTEGER 

3 AXIS INTEGER 

4 USAGE INTEGER 


5 SENDOC TEXT 80 


SENSOR ID NUMBER 
NODE NUMBER 
1,2,3 FOR X,Y,Z TRANSLATION 
4,5,6 FOR X.Y.Z ROTATION 
-1 FOR UNSPECIFIED OR 
SUM OF APPLICABLE, 1 FOR 
POSITION, 2 FOR 
VELOCITY (OR ANGULAR 
RATE), 4 FOR ACCELERATION 
(OR ANGULAR ACCELERATION) 
DESCRIPTION OF SENSOR 


DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 


DIMENSIONLESS 


SIMULATE 

SIMUALTION INFORMATION 


1 

SIM1D 

INTEGER 

2 

SIMDOC 

TEXT 80 

3 

SYSID 

INTEGER 

4 

SIMDATE 

DATE 

5 

ANALYST 

TEXT 40 

6 

TINIT 

REAL 

7 

TFINAL 

REAL 

8 

DELTAT 

REAL 

9 

DISPFILE 

TEXT 40 

10 

VELOFILE 

TEXT 40 

1 1 

ACCEHLE 

TEXT 40 


SIMULATION ID NUMBER 
DESCRIPTION OF SIMULATION 
CONTROL SYSTEM ID NUMBER 
DATE OF SIMULATION 
NAME OF CONTROLS ANALYST 
SIMULATION START TIME 
SIMULATION END TIME 
UNIFORM TIME STEP 
MODAL DISPLACEMENT FILE 
MODAL VELOCITY FILE 
MODAL ACCELERATION FILE 


DIMENSIONLESS 

DIMENSIONLESS 

DIMESNIONLESS 

DIMENSIONLESS 

DIMENSIONLESS 

T 

T 

T 

DIMENSIONLESS 

DIMESNIONLESS 

DIMENSIONLESS 
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Schema 1 1 


STRNENG 

STRAIN ENERGY DATA 



ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

CMPONENT 

INTEGER 

GROUP NUMBER 

DIMENSIONLESS 

2 

ELEMENT 

INTEGER 

ELEMENT NUMBER 

DIMENSIONLESS 

3 

EL-TYPE 

TEXTS 

ELEMENT TYPE 

DIMENSIONLESS 

4 

STENT 

REAL 

TOTAL STRAIN ENERGY 

ML**2/T**2 

5 

STEND 

REAL 

TOTAL STRAIN ENERGY 
DENSITY 

M/(LT**2) 

6 

PERCENT 

REAL 

PERCENT OF TOTAL STRAIN 
ENERGY FOR ELEMENT 

DIMENSIONLESS 

7 

STENMD 

REAL 

MEMBRANE STRAIN ENERGY 
DENSITY 

M/(LT**2) 

8 

STENB 

REAL 

BENDING STRAIN ENERGY 

ML**2/T**2 

9 

STENBD 

REAL 

BENDING STRAIN ENERGY 
DENSITY 

M/(LT* *2) 

10 

STENMB 

REAL 

MEMBRANE-BENDING STRAIN 
ENERGY 

ML**2/T**2 

1 1 

STENMBD 

REAL 

MEMBRANE-BENDING STRAIN 
ENERGY DENSITY 

M/(LT* *2) 

12 

CONDNUM 

INTEGER 

LOAD-CASE ID 
OR MODE NUMBER 

DIMENSIONLESS 

13 

STRNCOL 

INTEGER 

COLOR FOR A GROUP OF 
ELEMENTS 

DIMENSIONLESS 
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Schema 12 


SYSTEM 

LINEAR SYSTEM PARAMETERS 



ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

SYS1D 

INTEGER 

SYSTEM ID NUMBER 

DIMENSIONLESS 

1 

Am 

MODES 

IVEC VAR 

VIBRATION(>0) OR NEWTONIAN 
RIG1D-B0DY(-1 TO -6) MODES 

DIMENSIONLESS 

3 

CONTROLS 

1VEC VAR 

ID NUMBER(ACID'S) 
OF ACTUATORS 

DIMENSIONLESS 

4 

SENSORS 

IVEC VAR 

ID NUMBER (SENSID'S) 
OF SENSORS 

DIMENSIONLESS 

5 

EXFORTOR 

IVEC VAR 

ID NUMBERS (EXAPID'S )OF 
EXTERNAL FORCE/TORQUE 

DIMENSIONLESS 

6 

SYSDOC 

TEXT 80 

DESCRIPTION OF SYSTEM 

DIMENSIONLESS 


TRIANGLS 

THREE NODE ELEMENTS 



ATTRIBUTE 

TYPE 

DESCRIPTION 

UNITS 

1 

CMPONENT 

INTEGER 

GROUP NUMBER 

DIMENSIONLESS 


ELEMENT 

INTEGER 

ELEMENT NUMBER 

DIMENSIONLESS 

3 

NODE1 

INTEGER 

FIRST NODE IN ELEMENT 
CONNECTIVITY 

DIMENSIONLESS 

4 

NODE2 

INTEGER 

SECOND NODE IN ELEMENT 
CONNECTIVITY 

DIMENSIONLESS 

5 

NODE3 

INTEGER 

THIRD NODE IN ELEMENT 
CONNECTIVITY 

DIMENSIONLESS 

6 

EL-TYPE 

TEXT 8 

ELEMENT TYPE 

DIMENSIONLESS 

7 

MATERIAL 

TEXT 8 

MATERIAL NAME 
OR ID NUMBER 

DIMENSIONLESS 

8 

TH1CKNES 

REAL 

PLATE OR SHELL THICKNESS 

L 

9 

NONSTWHT 

REAL 

NON-STRUCTURAL MASS 
PER UNIT AREA 

M/L* *2 
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APPENDIX B 


IMAT EXAMPLE 
PROBLEM 

Introduction -------------- - B-l 

Phase I Structural Analysis ------------- B-l 

Phase II Control and Design Analysis --------- B- 4 

Phase III Simulation - -- -- - B-ll 

Phase IV Data Recovery ---------- - B-13 



IMAT Example Problem 1 


Introduction 

The physical system that is modeled in the IMAT example problem consists 
of three concentrated masses connected in series by linear springs (modeled 
with rod elements in IMAT). Modal proportional damping is used to account 
for the passive damping in the system. Each mass is free to translate along 
the horizontal axis only, and there are position and rate sensors attached to 
each mass. Actuators are attached to masses nri| and m2- In this example, 

control gains applied to the state variables are determined by an optimal 
control law. The objective of the optimal control is to minimize the transient 
response of the system to a disturbance, f, or to initial displacements 
without resorting to excessive control forces. Therefore a compromise is 
required in calculating feedback gains. This leads to an optimal regulator 
problem in which a set of constant gains are determined to minimize a 
specified performance index. 

Step numbers refer to the steps presented in the Overview of the IMAT 
Solution Procedure. 

Phase I. Structural Analysis 

Steps 1-4. Create Finite Element Model 


Mass-spring System 
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IMAT Example Problem 2 


Step 


Notations 

p: physical displacement coordinates (signal 

observation points) 

m: masses 

k: spring constants 

u: control forces 

f: disturbance force 

NOTE: damping is accounted for by introducing 
proportional modal damping later in the 
problem formulation 

Numerical Data: 

m l = 2, m 2 = 1, m 3 = 3 

k j = 1, k^ = 2 

5 . EXECUTE MSC/NASTRAN - Normal Modes Analysis 
Equations of Motion for Undamped Free Vibration 
Mp + Kp = 0 

where 




0 

0 “ 


“2 

0 

0 " 

M = 

0 

m 2 

0 

zz 

0 

1 

0 


0 

0 

m 3 _ 


_0 

0 

3_ 
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IMAT Example Problem 3 


K 



Solutions : co j = natural frequencies (rad/sec) 

2 

(oj = j , where X,j is the ith eigenvalue of [M - X K] = 0 ) 

<J> = matrix of undamped mode shapes 

(each column represents one mode shape, 
or eigenvector) 

Normalize Mode Shapes to Satisfy 

= I 


Numerical Results 



CO, 

0 

0 “ 


" 0 

0 

0 " 

[CO] = 

0 

W 2 

0 

= 

0 

0.7427 

0 


0 

0 

<°3_ 


_ 0 

0 

1 . 8974 _ 


<h 


'0.4075 0.5575 0.1460' 

0.4075 -0.0597 -0.9093 

0.4075 -0.3518 0.2057 


Step 6. Store Mode Shapes, Frequencies, and Mass Properties in 
IMAT-defined database. 
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IMAT Example Problem 4 


Phase II. Control Design and Analysis 

Step 7. Use DEFINE CONTROL SYSTEM processor to define control 
system 

Define Generalized (Modal) Coordinates, q 
p = O q 


Rewrite Equations of Motion, including Modal Damping, Control 
Forces, and Disturbances 


q + [2CcoJ q + [co 2 ]q = <I> T B c u(t) + <P T B f f(t) 

where 


I 2 £ to ] 


0 

0 

0 


0 

0.0074 

0 


0 

0 

0.0190 


0.5% critical damping 
k for each mode 


1 01 


B 


0 1 
-0 0 - 


Control Influence Matrix 
(controllers at m ] and m^) 


Bf = 


'O' 

0 

. 1 . 


Disturbance Influence Matrix 
(applied external force at m 3 ) 
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IMAT Example Problem 5 


Step 8. Run GENERATE LINEAR SYSTEMS MATRICES (GLSM) to 
create systems matrices 

NOTE: GLSM writes these matrices in compressed form. 

You must use MATRIXx to expand them to the full 
form shown below. 

x = Ax + 6u 

y = fcx + Du 

where the state space vector must be defined as 

X = [<1, ^2 ^3 ^2 ^ 3 ] T 
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IMAT Example Problem 6 


Step 9 






"" 0 0 — 






0 0 



r ° 









0 0 



T 



0.4075 0.4075 



_ 0*B C 








0.5575 -0.0597 






_ 0.1460 -0.9093 _ 




0.4075 0.5575 0.1460 1 

| 

o 

o 

o 

[<D 

10] = 

1 

0.4075 -0.0597 -0.9093 1 

| 

0 0 0 



1 

_0.4075 -0.3518 0.2057 1 

0 0 o _ 

- 

0 


0 

-| 



0 


0 




0 


0 




Run MATRIXx to calculate control gain matrix (Skip this 
step if gains given or other method is desired) 


Form system (S) matrix in MATRIXx as 


A 1 

6 

i 1 

D 
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IMAT Example Problem 7 


Choose Cost Function 


P 


oc 

I 


(x‘Qx + u L Ru)dt 


where Q = I (identity matrix) 

R = I 

Use REGULATOR function in MATRIXx to solve Ricatti Equations 
and obtain Optimal Gain Matrix, G 


0.5517 0.5090 -0.1558 1.2036 1.1926 0.2094 

0.8352 -0.1994 -0.7753 2.0760 0.8445 0.8281 


Step 10. Assemble closed-loop plant (A c ) matrix in MATRIXx 


Closed-loop Model 


x = A c x + fef 

y = fcx 
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IMAT Example Problem 8 


where 


A c = 

A - 


(G=gain matrix) 


0 

0 

0 

1 0 

0 

0 

0 

0 

0 1 

0 

0 

0 

0 

0 0 

1 

-0.5647 

-0.3022 

0.4365 

-1.3497 -0.1291 

0.3111 

-0.2578 

-0.8214 

0.0322 

-0.5451 -0.7426 

-0.1748 

0.6778 

0.1372 

-4.4096 

1.7413 -0.9705 

-0.9342 


Step 11. Run MATRIXx to calculate the closed-loop eigenvalues and 
damping ratios 


Closed-loop Eigenvalues 

"" -0.5091 + 1.8505i " 

' -0.5091 - 1.8505i 

-0.5971 + 0.4928i 

\ - 

-0.5971 - 0.4928i 

-0.3980 + 0.7 1 5 li 
— -0.3980 - 0.7 1 51i _ 

Since the real part is negative for all roots, the system is 
stable 
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Closed-loop Damping Ratios 


fCcl 


0.7713 0 0 

0 0.4863 0 

0 0 0.2652 


NOTE: Bode plots provide another useful means for 

determining the stability of a system. Bode plots may 
be obtained by using the MATRIXx BODE command. 

The following example shows a MATRIXx Bode plot of 
the loop transfer function for an input (actuator force) 
at mass and an output (position) at mass mj . 
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Phase III. Simulation 

Step 12. Read disturbance influence matrix, E, created by GLSM into 
MATRIXx 



0 

0 

0 


0.4075 

-0.3518 

0.2057 


Step 13. Calculate transient response to impulse load applied at m 3 and 

save modal solution in formatted MATRIXx files. Also save 
force/time histories of actuators and applied external loads. 
The following MATRIXx plot shows the physical 
displacements at the three nodes caused by an impulse 
applied at node 3. Additional physical quantities such as 
stresses could be obtained by using the Physical Data 
Recovery procedure. 
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01234 56789 10 

TIME 


Simulation Results for Impulse Load at Node 3 


Step 14. Run RECORD CONTROL SIMULATION to store the information 
describing the simulation. 
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Phase IV. Data Recovery 

Step 15. Run RECOVER PHYSICAL OUTPUT processor to create UHV 

(modal solution) file in MSC/NASTRAN INPUTT4 format and 
to create an MSC/NASTRAN Modified Solution 31 restart 
data deck that contains requests for physical time-history 
plots. 


Contents of MATRIXx Solution Files 



Contents of MSC/NASTRAN UHV File 


NOTES : 


1. 

q = modal coordinate of 

mode i 

at time 

step j 


2. 

x (t) = (q x (t) q 2 (t) ... 

q n (t) 

q x (t) 

q 2 (t) ... 

q n (t)) 

3. 

x(t) = ( q x (t) q 2 (t) ... 

3 

ft 

q x (t) 

q 2 (t) ... 

q n <t>> 
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Step 16. Run MSC/NASTRAN modified Solution 31 to obtain 

physical results. Alters shown below are automatically 
created by the RECOVER PHYSICAL OUTPUT processor. 


ALTERATION OF SOLUTION SEQUENCE 31 
TO RECOVER PHYSICAL RESULTS 


SOLUTION 31 (MODAL TRANSIENT 
ANALYSIS) RESTART 


READ [M], [B], [K], [ <t» ] & [f] FROM OPTP 


( 


USE CUSTOMIZED ALTER TO 

DELETE MODES THAT WERE NOT 
USED IN SIMULATION 


) 


COMPUTE PHYSICAL RESULTS 
PER UNIT MODAL DEFLECTION 

[u ( h ) ] = [<i>][u (h)] 

0 a 

[ CT ( h ) ] = [<r][u ( h ) ] 

9 


cc 

UJ 


SKIP TRANSIENT SOLUTION 
CALCULATION, AND READ 
SIMULATION RESULTS, u h ( t ) 
FROM UTILITY FILE 
GENERATED BY MATRIXx 




RECOVER SC 
(MODAL) RE 
GENERATE 

JLUTION SET 
SULTS AND 
XY PLOTS 


CALCULATE PHYSICAL 
RESULTS vs TIME 

[a (t)] = [a ( h )][u (t)] 

h 


I GENERATE XY PLOTS 1 

1 OF PHYSICAL 

RESULTS j 





EXIT 
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The growing problem of processing raster image data at LaRC is 
caused by the increasing number of software packages that generate 
raster data and the increasing number of graphics output devices 
that process this data. The result of this growth is the continual 
development of translators which convert a package-specific raster 
output file into a device-specific raster input file. The problem is 
further complicated by the requirement to transport these raster 
image data files (normally written in a binary format) from one host 
to another in order to access a specific device. 

In order to provide some degree of compatibility for locally 
generated raster image data, LaRC has adopted a generic raster 
format known as Raster Metafile (RM) format. A prototype version 
of the Raster Metafile Translator (RMT) interpreter has been 
designed to permit the display and manipulation of RM formatted 
images. 

The RM format and RMT do not eliminate the requirement for 
translators since package-specific raster data must be converted into 
RM format. However, the translation process terminates with RM 
format from the user’s standpoint because the RMT should interface 
with all supported raster devices. 

Since RM formatted images are generated from within IMAT utilities, 
no further discussion of the specifications of the RM format is 
included. 

The remaining discussion focuses on the functionality of the 
prototype RMT interpreter. The command-driven RMT, which may 
be run in the foreground or background, provides for the reading, 
writing, display, and manipulation of RM format images. Image 
manipulation operations include format conversions, image 
composition, revising, clipping, and channel selection. A description 
of each command, including proper syntax is presented in the 
following pages. 
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CONVERT (CONV) 

Purpose: To convert an RM formatted image from intensity (color 

table) to color table (intensity) format. 

Parameters: 

Required — input metafile number 

output metafile number 

Optional — picture number 

window number 

If the optional parameters are omitted, the current defaults (see 
SET/GET default command) are used. A range may be substituted for 
the picture number (see DIRECTORY command for range 
specification). 

When converting from intensity to color table format, the user is 
prompted for desired color lookup table (LUT) size information. 
Defaults are obtained from the device specification (if a device is 
loaded) or from the number of data bits in the input image. When 
the black-and-white flag is on (see SET COLOR), the conversion 
process produces a single channel intensity image. 

Usage: 

CONVERT METAFILE # <PICTURE #> <WINDOW #> METAFILE # 

CONV MF # <P #> <W #> MF # 


NOTE: # refers to the index number of the metafile, picture, 
window, or viewport. 
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COPY 

Purpose: To copy designated RM formatted images from an input 

metafile to the end of an output metafile. 

Parameters: 

Required — input metafile number 

output metafile number 

Optional — picture number 

If the picture number is not supplied, the default (see SET/GET 
default command) is used. A range may be substituted for the 
picture number (see DIRECTORY command for range specification). 

Usage: 

COPY METAFILE # <PICTURE #> METAFILE # 

COPY MF # <P #> MF # 


DIRECTORY (DIR) 

Purpose: To display the contents of an RM formatted image file by 

printing header information for the selected image range. 

Parameters: 

Required — metafile number 

Optional — image range 

If the range is omitted, the headers for all images on the file are 
displayed. The range specification is available on several commands 
and takes the form from <first imago to clast imagowhere the image 
designators may be the keywords FIRST, CURRENT, or LAST, 
absolute (integer) image numbers, or relative (integer) offsets 
designated by + or 
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Usage: 

DIRECTORY# 

DIR # 

DIR # FROM FIRST TO LAST 
DIR # FROM 2 TO 4 
DIR # FROM -1 TO +2 


DRAW (D) 

Purpose: To draw RM formatted image to selected graphics output 

devices. 

Parameters: 

Required — none 

Optional — metafile number 

picture number 
window number 
viewport number 

If optional parameters are not selected the current default (see 
SET/GET default command) is used. A range may be substituted for 
the picture number (see DIRECTORY command for range 
specification.). 

Usage: 

DRAW <METAFILE #> <PICTURE #> <WINDOW #> <VIEWPORT#> 

D <MF #> <P #> <W #> <V #> 


GET 


Purpose: To get current options and default values. 
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The GET subcommands include: 

METAFILE (MF) 

WINDOW (W) 

VIEWPORT (V) 

DEFAULT (DEF) 

OPTION (OPT) 

CHANNEL (CHA) 

ERROR (ERR) 


GET METAFILE (GET MF) 

Purpose: Inquire about metafile name associated with specified 

metafile number. 

Parameters: 

Required — metafile number 
Optional — none 
Usage: 

GET METAFILE # 

GET MF # 


GET WINDOW (GET W) 

Purpose: Inquire about window coordinates for specified window 

number. 

Parameters: 

Required — window number 
Optional — none 
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Usage: 

GET WINDOW # 
GET W# 


GET VIEWPORT (GET V) 

Purpose: To inquire about viewport coordinates for a specified 

viewport number. 

Parameters: 

Required — viewport number 
Optional — none 

Usage: 

GET VIEWPORT # 

GET V # 


GET OPTION (GET OPT) 

Purpose: To inquire about supported RMT options including: log 

file status, alternate command file name (if any), quantization 
scheme, dithering flag, clipping/resizing flag, and color vs 
black-and-white flag. 

Parameters: 

Required --- none 

Optional — none 

Usage: 

GET OPTION 
GET OPT 
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GET DEFAULT (GET DEF) 

Purpose: To inquire about RMT defaults including metafile, picture, 

window, and viewport numbers. 

Parameters: 

Required — none 

Optional — none 

Usage: 

GET DEFAULT 
GET DEF 

GET CHANNEL (GET CHA) 

Purpose: To inquire about the designated number of channels and 

channel ordering. 

Parameters: 

Required — none 

Optional — none 

Usage: 

GET CHANNEL 
GET CHA 

GET ERROR (GET ERR) 

Purpose: To inquire about the current error termination level. 

Parameters: 

Required — none 
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Optional — none 

Usage: 

GET ERROR 
GET ERR 


HELP (H) 

Purpose: To access the on-line HELP documentation for individual 

RMT commands. 

Parameters: 

Required — none 

Optional — specific command names 

Usage: 

HELP 

HELP <command> 

HELP <command> <SUBCOMMAND> 


OVERLAY (OVER) 

Purpose: To overlay one or more RM formatted images to produce 

a composite image. 

Parameters: 

Required — input metafile number 
output metafile number 

Optional — picture number 

window number 
viewport number 
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If optional parameters are omitted, the default (see SET/GET default 
command) values are assumed. No range specification is allowed 
with this command. 

The resolution of the composite image is determined by the extent of 
supplied viewport dimensions. 

Usage: 

OVERLAY METAFILE # <PICTURE #> <WINDOW #> <VIEWPORT #> & 
METAFILE # <PICTURE #> <WINDOW #> cVIEWPORT #> & ... 
METAFILE # 

OVERLAY MF # <P #> <W #> <V #> MF # <P #> <W #> <V #> ... MF # 


QUIT (Q) 

Purpose: To exit the RMT program. 

Parameters: 

Required — none 

Optional — none 

Usage: 

QUIT 

Q 


SCALE (SCA) 

Purpose: To scale the number of data bits in an input intensity 

image or size of LUT entries in a color table image. 
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Parameters: 

Required --- input metafile number 
output metafile number 
number or bits by which output image 
is scaled 

Optional — picture number 

window number 

If optional parameters are not supplied, the defaults (see SET/GET 
default command) are used. A range may be substituted for the 
picture number (see DIRECTORY command for range specification). 

Usage: 

SCALE METAFILE # <PICTURE #> <WINDOW #> METAFILE # NUMBIT # 
SCA MF # <P #> <W#> MF # N # 

SET 

Purpose: To set options or override defaults. 

The available SET subcommands are: 

METAFILE (MF) 

WINDOW (W) 

VIEWPORT (V) 

LOG (L) 

QUANT (Q) 

DEFAULT (DEF) 

DITHER (DIT) 

CLIP (C) 

CHANNEL (CHA) 

COLOR (COL) 

ERROR (ERR) 
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SET METAFILE (SET MF) 

Purpose: To identify an RM for reading or writing. 

Parameters: 

Required — metafile number (may range from 1 to 5) 
Optional — write flag 

. * 

When the write flag is omitted the metafile is opened for reading 
only. 

Caution: when a metafile is opened for writing, no other read 
processing operations are allowed without first exiting the RMT (i.e., 
commands like DIR and DRAW are not allowed for output metafiles). 
Also, the output metafile required for several commands (such as 
CONVERT or OVERLAY) must be opened for writing. 

Usage: 

SET METAFILE # <WRITE> 

SET MF # <W> 


SET WINDOW (SET W) 

Purpose: To set an RMT window (used to designate a subset of an 

RM formatted image). 

Parameters: 

Required — window number ( may range from 1 to 10) 
window dimensions (in terms of minimum 
and maximum horizontal and vertical extents) 

Optional — none 
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Usage: 

SET WINDOW # (X-MINIMUM X-MAXIMUM Y-MINIMUM 
Y-MAXIMUM) 

SET W # (X-MINIMUM X-MAXIMUM Y-MINIMUM Y-MAXIMUM) 


SET VIEWPORT (SET V) 

Purpose: To set an RMT viewport (used to position and size an RM 

image for display or output). 

Parameters: 

Required --- viewport number (may range from 1 to 10) 

viewport dimensions (minimum and 
maximum horizontal and vertical extents) 

Optional — none 

Usage: 

SET VIEWPORT # (X-MINIMUM X-MAXIMUM Y-MINIMUM 
Y-MAXIMUM) 

SET V # (X-MINIMUM X-MAXIMUM Y-MINIMUM Y-MAXIMUM) 

SET LOG (SET L) 

Purpose: To toggle the flag to write the RMT log file, RMT.LOG. 

(This log file may be used as an alternate command file (see 
SOURCE command).) 

Parameters: 

Required — none 

Optional — write flag (ON/OFF or +/-) 

default is OFF. 
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Usage: 

SET LOG ON 
SET L + 


SET QUANTIFY (SET Q) 

Purpose: To set the uniform quantization flag used in converting 

from intensity to color table format. 

Parameters: 

Required — none 

Optional — quantify flag (ON/OFF or +/-) 

ON implies the use of uniform quantization and OFF implies the 
use of a color cube quantization scheme (the default is ON). 

Usage: 

SET QUANTIFY ON 
SETQ + 


SET DITHER (SET DIT) 

Purpose: To set the dither flag used in converting from intensity to 

color table format. DITHER ON overrides the quantization scheme 

(see SET QUANTIFY command). 

Parameters: 

Required — none 

Optional — dither flag (ON/OFF or +/-) 

(the default is OFF.) 

If dither is ON, it overrides the uniform quantization flag (see SET 
QUANTIFY). 
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Usage: 

SET DITHER ON 
SET DIT + 


SET CLIP (SET C) 


Purpose: To set the clip flag used to determine whether to clip 

image at viewport boundaries or resize image (using a bi-linear 
interpolation scheme) to fit the viewport. 

Parameters: 

Required --- none 


Optional - - - dip flag (ON/OFF or +/_) 

(the default is ON implying clipping.) 

Usage: 


SET CLIP ON 
SETC + 


SET DEFAULT (SET DEF) 

Purpose: To override an RMT default. 

Parameters: 

Required --- new default name 

new default number 

Optional — picture number 
window number 
viewport number 

(the default value for all parameters is 1) 
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Usage: 

SET DEFAULT <METAFILE, PICTURE, WINDOW, VIEWPORT> # 
SET DEF <METAFILE, PICTURE, WINDOW, VIEWPORTS # 


SET CHANNEL (SET CHA) 

Purpose: To override the default number of channels and/or the 

channel selection order for multi-channel image data. 

Parameters: 

Required — none 

Optional — number of channels 

By default the RMT assumes 3 channels ordered 1, 2, and 3 
corresponding to red, green, and blue channel The user may alter 
this by supplying a new number of channels and/or channel 
ordering, (supplying 0 (zero) for the number of channels informs the 
RMT to use the number of channels in the input metafile image.) 

Usage: 

SET CHANNEL # (#1 #2 #3 ... ) 

SET CHA # (#1 #2 #3 ... ) 

SET COLOR (SET COL) 

Purpose: To set color flag used in conversion process when 

converting from (to) color to (from) black-and-white. 

Parameters: 

Required — none 

Optional — color flag (ON/OFF or +/-) 

(the default is ON.) 
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The effect of the color flag being off is to produce a single channel 
intensity image (corresponding to a black-and-white image) during 
conversion operation (see CONVERT command). 

Usage: 

SET COLOR ON 
SET COL + 

SET ERROR (SET ERR) 

Purpose: To set error termination level. 

Parameters: 

Required — none 


Optional 

error termination level 
S syntax 

W warning 

F fatal 

N none 

(default is F - fatal). 

Usage: 

SET ERROR <SYNTAX,WARN1NG,FATAL,N0NE> 
SET ERR <S,WJ%N> 

SOURCE (SOU) 


Purpose: To read 

command input from alternate command file 

Parameters: 

Required — 

alternate command file name 

Optional — 

none 


Nesting of alternate command files is not permitted. 
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Usage: 

SOURCE FILENAME 
SOU FILENAME 
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